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Preface 





The objective of this book is to help installation managers and system programmers 
plan for, install, and use SMF in an MVS/XA system. This book describes: 


e The basic relationship of SMF to the operating system 
e Possible uses of SMF data 


e How to add user-written routines to the appropriate SMF exits either before 
or after SYSGEN 


e The system areas that require additional storage for SMF and approximately 
how much additional storage is needed in each area 


e How to execute the SMF dump program 


e How to use an SMFPRMxx member of SYS1.PARMLIB to define the use of 
SMF 


e How to write records to installation-defined or SMF-defined data sets 





e@ How to plan and write exit routines that will monitor jobs or job steps at various 
points during their processing cycle 


e How to test user-written routines using the TESTEXIT procedure 
e How to design report programs that format and print the data from SMF records 
e The information contained in each SMF record 


an Note: In addition to Version 2 of the MVS/System Products, this edition also 
( | includes the following program products: 


OS/VS2 MVS Programmed Cryptographic Facility 5740-XY5 
OS/VS2 MVS Cryptographic Unit Support 5740-XY6 

OS/VS2 MVS ACF/VTAM 5735-RC2 

OS/VS2 MVS Resource Measurement Facility (RMF) 5665-274 
OS/VS2 Sort/Merge - Release 5 5740-SM1 


Related Publications 


The. following manuals should be available for reference while you are reading 
this SRL: 





MVS/Extended Architecture Resource Measurement Facility LC28-1138 
Version 3 Reference and User’s Guide | 
MVS/Extended Architecture Message Library: System Codes GC28-1157 
MVS/Extended Architecture Message Library: System GC28-1156 
Messages 
MVS/Extended Architecture Operations: System Commands GC28-1206 
MVS/Extended Architecture Conversion Notebook ~GC28-1143 
MVS/Extended Architecture JCL GC28-1148 
MVS/Extended Architecture Debugging Handbook Volume 1  LC28-1164 
MVS/Extended Architecture Debugging Handbook Volume 2 LC28-1165 
MVS/Extended Architecture Debugging Handbook Volume 3 LC28-1166 
MVS/Extended Architecture Debugging Handbook Volume 4  LC28-1167 
MVS/Extended Architecture Debugging Handbook Volume 5  LC28-1168 
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MVS/Extended Architecture System Programming Library: 


Initialization and Tuning 


MVS/Extended Architecture System Programming Library: 


JES3 Initialization and Tuning 


MVS/Extended Architecture System Programming Library: 


JES2 Initialization and Tuning 


MVS/Extended Architecture System Programming Library: 


System Modifications 


MVS/Extended Architecture System Programming Library: 


System Macros and Facilities Volume 1 


MVS/Extended Architecture System Programming Library: 


System Macros and Facilities Volume 2 
MVS/Extended Architecture Data Management Services 


MVS/Extended Architecture System Programming Library: 


JES3 User Modifications and Macros 
MVS/Extended Architecture Utilities 


MVS/Extended Architecture System Programming Library: 


31-Bit Addressing 


Notational Conventions 


GC28-1149 


SC23-0059 


SC23-0065 


GC28-1152 


GC28-1150 


GC28-1151 


GC26-4013 
SC23-0060 


GC26-4018 
GC28-1158 


The parameters and instructions shown in this publication use the following 


notational conventions: 


e Bold type letters, words, and symbols: ' code them exactly as shown. 


e Italic type letters. words, and symbols: substitute specific information. 


~@ (blank characters): code a blank. 


e {} (braces): code only one of the items or use the default value. Do not code 


the braces. 


enclosed in the brackets. 


@ Underscores: if you do not code a value, the underscored one is the default. 


System Management Facilities (SMF) 





[ ] (brackets): code any enclosed item or items — they are optional. Do not 
code the brackets but specify commas if they are included with the items 


| (OR signs): select only one of the items separated by the OR signs. 
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Summary of Amendments 


Summary of Amendments 
for GC28-1153-5 
for MVS/System Product Version 2 Release 2.0 


This edition contains: 


Updates to Figures 3-1 (SMFPRMxx Parameters) and 6-3 (Summary of SMF 
Records). 


A description of the subtype selectivity function in Part II of Chapter 3. 


e Updates to record type 16 — DFSORT Statistics. 


Updates, to take into account the subtype selectivity function, for record 
types 24 (18) - JES2 Spool Offload, 30 (1E) - Common Address Space Work 
Record, and 32 (20) - TSO User Work Accounting Record. 


The addition of record type 36 (24) - Integrated Catalog Facility Catalog and 
record type 41 - Data-In-Virtual ACCESS/UNACCESS record. 


Updates to record types 70 - 79. 


In record type 59 (3B) - MVS/BDT File-to-File transmission record, the 
Transaction Type Section for Network Job Entry (NJE) is added. 


Updates to Chapter 7, “‘Field-to-Record-Cross-Reference.” 


In addition, other minor technical and editorial changes have been made. 


Summary of Amendments 

for GC28-1 153-4 

as Updated June 1986 

for MVS/System Product Version 2 Release 1.7 


The changes in this major revision include: 


Updates to the exit routines IEFUII and IEFACTRT found in 
Chapter 4. 


The additions of record type 38 (26) — Network Performance 
Monitor Statistics and record type 39 — Network Logical Data 
Manager. 


Record type 37 — Network Problems Determination Application, 
record type 79 — Monitor II Activity are updated. 


Updates to figures 10-3 (IEFUJI — Job Initiation Exit and IEFUSI — 
Step Initiation Exit) and 10-9 TEFACTRT — Termination Exit). 


In addition, other minor technical and editorial changes have been 
made. 
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Summary of Amendments 

for GC28-1153-3 

as Updated January 16, 1986 

by Technical Newsletter GN28-1095 


This Technical Newsletter, which supports MVS/System Product Version 2 
Release 1.3, consists of: 


e Updates to record type 21 (15) — Error Statistics by Volume. 
e@ The addition of record type 102 (66) - DATABASE 2 Performance. 
e Additions to Chapter 7 “Field-to-Record-Cross-Reference”’ 
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é Chapter 1: Introduction 


SMF (System Management Facilities) collects and records a variety of system and 
job-related information. SMF formats the information into a number of different 
records. System-related SMF records include information about the configuration, 
paging activity, and workload; job-related records include information on the CPU 
time, SYSOUT activity, and data set activity of each job step, job, and TSO session. 


By creating analysis and report routines, installations can use the information in 
SMF records in many ways. For example, the collected information is useful in 
producing reports for billing users, for analyzing the workload, or for profiling 
system resource usage. 


SMF runs in its own address space (SMF). Because the SMF address space 
contains the SMF control blocks and buffers, an installation can restart SMF. If 
SMF fails, an installation does not have to re-IPL to regain SMF recording capabili- 
ties. The SET command can be used to restart SMF. An IPL might be necessary to 
restart SMF if the system management facilities control area (SMCA) has been 
destroyed. 


SMF also provides exits that allow installations to add routines to the control 
a5, program to perform additional processing. User-written routines at SMF exits . 
( receive control at different times during a job’s flow through the system. They also 
receive control when specific events occur, such as when a job CPU-time limit 
expires. These user-written routines could collect additional information, cancel 
jobs, or enforce installation standards. 


Because SMF data-collection routines and exit routines are independent of each 
other, they can be used in combination or separately. For example, by analyzing 
the information SMF data-collection routines obtain, an installation can set a time 
limit for all jobs running on the system. Any job exceeding this limit is auto- 
matically terminated. However, if an installation would like certain jobs to exceed 
the time limit, a routine can be added at the SMF time limit exit, IEFUTL. This 
exit routine could then extend the time limit for selected jobs. 


SMF Overview 


Figure 1-1 and its associated paragraphs provide an overview of SMF. The use of 
SMF will vary from installation to installation according to: (1)the SMF 
parameters selected, (2) the exit routines added, and (3) the analysis/report 
routines used to summarize the collected data. 
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Figure 1-1. SMF Overview 
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Most system components contain routines that provide data to SMF. Some system 
routines (such as timer supervisor routines) collect a single data item and | 
accumulante the value of the item in an SMF control block. Other routines build 
a record of various data items and use SVC 83 to eventually transfer the record to 
the SMF data set. 


For information on: (1) the system routines that interface with SMF to write 
records, (2) the specific events that cause SMF to write records, and (3) the 
contents of each record, see the chapter “SMF Records”. To locate a specific 
system or job-related data item, use Chapter 7, the “Field-to-Record Cross- 
Reference”, which alphabetically lists all the data items (or ‘fields’) in the 
SMF records. 


In addition to collecting data for SMF, some system routines interface with 


the SMF exits. These system routines pass control to the SMF exits at 


several points during job and job step processing. They also pass control to 
the SMF exits when specific events occur, such as when the output limit of a 
data set is exceeded. For a description of the interface between these system 
routines and the SMF exits, see the chapter “User-Written Exit Routines’’. 


An installation can include routines for any or all of the SMF exits. These 
user-written routines could: 


e Enforce installation standards for resource requests, accounting fields, 
and naming conventions 


e Supply defaults for missing or incorrect parameters to avoid unnecessary 
job termination 


e@ Collect installation-dependent job information and write it to the SMF 
data set for further analysis 


Several programming facilities are available for user-written exit routines. 
These facilities, such as the common exit parameter area and the SMFWIM 
macro instruction for writing to the SMF data sets, are common to most exit 
routines. The chapter “User-Written Exit Routines” describes the 
programming facilities that SMF provides. That chapter also lists 
programming restrictions that apply to the exit routines, mentions several 
sample routines, and shows a procedure for testing the exit routines. For 
information on adding the user-written routines to the control program, see 
‘Including User-Written Exit Routines in the Operating System” in the chapter 
“System Requirements and Considerations”. 


SMF routines: 
e Collect and format data from job, system, and SMF control blocks 


e Build SMF data management records such as the SMF dump header and 
trailer records 


e Transfer records from the SMF buffer to the SMF data sets 


e Issue messages to the operator indicating the successful or unsuccessful 
completion of specific SMF-related events 
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The chapter “System Requirements and Considerations” lists the SMF 
storage requirements and several SMF performance considerations. 





An installation can vary the amount of information SMF routines collect and 
record by using several SMF parameters. The chapter “Defining the Use of 
SMF” describes the formats, uses, and default values of these parameters. 


There are many SMF data sets; each data set must be named SYS1.MANn, 
where n can be A through Z or 0 through 9. These data sets are filled alter- 
nately: while the SMF writer records on one data set, the others can be written 
out (or cleared). As long as one inactive data set is empty when the active data 
set becomes full, the SMF writer continues to record. | 


on 


At system initialization time, the first data set specified in the DSNAME para- 
meter of the SMFPRMxx parmlib member is used as the active recording data 
set unless it is full. SMF checks each data set in the order it is listed until it 
finds one that is not full. SMF then uses this data set and requests that the 
operator dump all data sets that are not empty. 


At SET SMF time, recording continues on the active data set unless the active 
data set was omitted from the new options. In that case, a switch is made to the 
first empty data set. For more information on the SET SMF command, see 
“Using the SET Command”, 





For additional information on allocating, dumping, and switching the data a 
séts, see the chapter “System Requirements and Considerations”. 


User-written analysis and report routines process the information recorded by 
SMF. Analysis routines could read the SMF data set, list the dumped SMF 
data set, use a sort/merge program to order the SMF-recorded information, or 
perform a detailed investigation of one particular SMF data item such as “job 
CPU time under TCBs’’. Report routines usually format and print the 
statistics and/or results of the analysis routines. For a description of sort/ 
merge routines and a sample report program, see the chapter “User-Written | 
Report Programs.” For examples and suggestions on creating reports from 
SMF data, see the following section, “Uses of SMF Data’. 


Uses of SMF Data 


The volume and variety of information in the SMF records enables installations to 
produce many types of analyses and summarizations. For example, by keeping 
historical SMF data and studying its trends, an installation can evaluate changes in 
the configuration, workload, or job scheduling procedures. Similarly, an installation 
can use SMF data to determine the amount of system resources that are wasted 
because of poor operational procedures or programming conventions: 





1-4 System Management Facilities (SMF) 














( | | The following examples illustrate the types of reports that can be created from 
= SMF data. The examples should be viewed primarily as suggestions to assist you in 
beginning SMF analyses and reports in the areas of: 


e Billing users 

Reporting reliability 

Analyzing the configuration 

Scheduling jobs 

Summarizing direct access volume activity 


Evaluating data set activity 


Profiling system resource utilization 


For example the Service Level Reporter (5668-966) can be used to report on 
reliability, scheduling jobs, and profile system resource utilization. 


Billing Users 


_SMF reports a great deal of data that installations can use as a basis for billing 
algorithms and reports. The following sample procedure briefly summarizes one 
approach installations might follow in creating billing algorithms and reports from 
SMF data: 


1. Establish the primary goal(s) that the installation wants to achieve from billing 
( - its users for computer services. | 


2. Break down these goals into specific billing objectives. 


3. Review the SMF-recorded data items (listed in Chapter 7) to determine the - 
data items that best satisfy the installation’s billing objectives. 


4. Create billing algorithms using the appropriate SMF-recorded data items. 


5. Generate billing reports for the installation’s users (or for management review). 


The examples that follow illustrate how different installations might implement 
this procedure. | 


| Example I. An installation whose primary goal is to recover its total cost 
(personnel, equipment, supplies, etc.) might set the following billing objectives: 


@ The billing algorithms and reports must not require expensive programming to 
control. 


e@ The users must easily understand the the charges. 


e The charges must be repeatable, that is, the charge for a job must be the same 
each time the job is run. 


Given these objectives, the installation might want to create a billing algorithm 
that is based on one specific SMF-recorded data item such as the “step CPU time 
under TCBs”, “number of cards read/punched”, or “number of lines/pages 
printed”’. 
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Example 2. An installation that has a limited variety of computer applications 
might have the following billing objectives: 


f 
\ 


@ The charges must accurately represent the amount of time required for each 
application. 


e The charges must be consistent for the same types of applications. (For 
example, all payroll applications must have the same base cost.) 


To fullfill these objectives, such an installation might take the following steps in 
creating its billing algorithms: 


1. Using SMF, establish an average-run time Gieoiah actual running or simulation) 
for each type of computer application. 


2. Estimate the average-run-time cost for each type of application. 
3. Set a cost-per-hour rate (using steps 1 and 2 above). 


4. Multiply this rate times the “job elapsed time” recorded by SMF for each 
application. | 


Example 3. An installation that is operating at or near full system capacity might 
want to encourage better use of its limited resources through billing. The major 
billing objectives of such an installation might include: 


@ The users must only pay for the system resources they use. 
e The rates for abundant resources must be lower than the rates for scarce ones. 


@ The charges for each system resource must fluctuate with the demand for that os 
resource. 


Assuming that it has cost-conscious users, the installation might use degradation 
and/or efficiency billing, as described later in this section, to satisfy these 
objectives. 


Example 4. An installation where the use of TSO is heavy might set these 
specific objectives: 


e TSO billing must be understandable to its users in the terms of the work they do. 


e@ The billing must be predictable; TSO users should be able to estimate the charge 
for a given terminal session. 


e The billing must recover TSO costs. 


The installation can use transaction billing, as described later in this section, to 
satisfy these objectives. 


Note: To use transaction billing for TSO commands, you must have installed MVS 
| TSO Extensions (5665-285). 
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Degradation Billing 


Installations can use degradation billing to enforce standards that were created to 
balance system resource usage. Degradation billing allows a user to process his job 
even though he has violated a specified resource-usage standard. However, because 

of the standard violation, the installation will charge the user an additional “punitive” 
cost for his job. For example, one installation standard might state that a single 

job step should not allocate more than six tape units out of the system’s available 
ten. Hence, for each of the first six tape units allocated, the installation will 

charge a base cost; however, for each unit allocated over the allowed six, it might 
charge a progressively increasing cost. 


Another installation standard might state that programs using the 
ADDRSPC=REAL facility should not allocate more than 100K bytes, and that 
any program allocating more than 300K bytes is not only violating the standard 
but is totally degrading the system. This installation might charge its users for 
ADDRSPC=REAL storage by establishing a price per K-storage hour used as 
follows (illustrated in Figure 1-2): 


e For an allocation of 100K bytes or less, the charge is a minimum base cost per 
K-storage hour. 7 


e@ For an allocation greater than 100K bytes but less than the critical level of 300K 
bytes, the charge is a higher base cost per K-storage hour plus a small “punitive” 
cost based on hour of tie-up. 


e Foran allocation of 300K bytes or more, the charge is a very large “punitive” 
cost based on hour of tie-up. 
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Figure 1-2. Sample Degradation Billing for ADDRSPC=REAL Storage 


Efficiency Billing 


Efficiency billing is very similar to degradation billing in that it encourages 
conservative use of system resources. Efficiency billing, however, reduces the 
charge for those who use the system efficiently. For example, by evaluating the 
“date” information in each SMF job initiation record, an installation might charge 
less for those jobs submitted for Sunday or holiday processing. Likewise, an 
installation might use the SMF-recorded “time” information to charge less for jobs 
started during the second or third shifts. Another example of efficiency billing is to 
give special reduced rates for jobs that represent low-priority background work. 
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Transaction Billing 


Note: To use transaction billing for TSO commands, you must have installed MVS 
TSO Extensions for MVS/XA (5665-293). 


Transaction billing charges for work in units that are meaningful to the user. Trans- 
action units can include executions of a particular program, online invocations of a 
defined function, or records read or printed by a standard application. Also, bills 
based on transaction units show a clear relationship between the service requested 
and the payment due, a relationship that, for TSO and IMS, is not apparent from a 
list of resources actually consumed. Techniques of specifying storage allocation, 
for instance, are not visible to many terminal users, who therefore have trouble 
relating their actions to a charge for storage hours. However, charging in terms of 
commands used is clear to the terminal user. 


Transaction billing enables the users, who see the correlation between what they 
do and what they pay, to develop cost-effective operating standards. If transaction 
prices incorporate the average cost of resources consumed, the users can evaluate 
alternatives and make rational decisions in the framework of their own operations. 


Example 4 suggests billing for the use of some TSO commands. To be suitable as 
a billing unit, a transaction should involve processing costs that are consistent enough 
over a period of time to be meaningfully averaged. The transactional billing data | 
collected for TSO is the number of each TSO command issued. A TSO command does 
not relate to the system resources manager (SRM) definition of a TSO transaction as 
described in Initialization and Tuning. The following steps can be used to develop 
a method of transaction billing, as described in example 4. 


1. Determine the TSO costs to be recovered. To determine the TSO cost, summarize 
the total installation cost and then allocate part of it to TSO. You can obtain a 
gross allocation ratio from the data in type 30 records by comparing the resource 
consumption for TSO with the overall resource consumption. 


2. For each type of TSO command, measure the average resource consumption and 
the number of times the command is used over a representative time period. You 
can obtain this data from type 32 records with the DETAIL option. For further 
discrimination, all calculations could be further broken down by specific user-id. 


3. Based on the number of commands issued (obtained during step 2) and any other 
relevant information, predict the command use by type for a billing period. 


4. Set rates for the resources measured in type 32 records, so that the use predicted 
in step 3 recovers the TSO costs from step one. That is, the resources used multi- 
plied by the rates set for the resources should equal the cost to be recovered. 


5. Set prices for each type of TSO command, based on the use of the command as 
determined in step 2, at the rates established in step 4. That is, divide the cost 
of the resources by the number of times the command was issued to determine 
the price for each command type. 


6. For the duration of each billing period, count the commands being issued by type 
and user-id from the data in the type 32 record. Use the prices determined in step 
5 to bill each user-id for the commands used. 


7. Repeat step 6 for each billing period until the prices must be recalculated. (De- 
ciding how often to recalculate the prices represents a trade off between accuracy 
and stability.) If costs have changed, start with step 1, otherwise start with step 2. 
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Reporting Reliability 


The examples that follow describe a few ways of using SMF to report the 
reliability of the system. 


Approximate System Availability — SMF produces records at IPL time and when 

the operator enters a HALT EOD command preceding the scheduled shutdown of 

the system. By examining these records and the last SMF record recorded prior to 
shutdown of the system, an installation can establish the following for a given time 
period: 

e Reporting interval 

e Number of IPLs 

e System up time and system down time 

@ 


Number of scheduled stoppages and the approximate amount of scheduled down 
time 

e Number of unscheduled stoppages and the approximate amount of unscheduled 
down time 


e Reason for system failure 


e Operator’s name 


In addition, JES2 and JES3 produce the SMF subsystem start (type 43) and sub- 
system stop (type 45) records. From these records, an installation can further 
analyze the system’s availability by checking the start times, stop times, and as 
circumstances under which JES2 or JES3 was started (for example, a cold start ae, 
versus a warm start). 


Abend Code Summary — SMF reports a system or user abend code for each job 
and job step that abends. By tracking those codes issued as a result of operational 
procedures (such as codes 122 and 222 for operator cancels), an installation can 
account for any loss of CPU time due to job reruns. More generally, a summary of 
the abend codes by program name or code allows an installation to determine 
which programs are abending frequently and which codes are occurring most often. 
This might show the need for software error corrections, JCL revisions, or better 
Operating instructions. 


Direct Access VTOC Errors — The SMF record type 19 has a “VTOC indicator” 
bit that is set if the system fails while a VTOC is being updated. By checking the 
setting of this bit, operations personnel can identify any VTOCs that might have 
missing tracks or overlapping data sets. 


Tape Error Statistics — The SMF type 21 records provide tape error statistics such 
as the number of temporary read and write errors, permanent read and write errors, 
noise blocks, erase gaps, and cleaner actions. By sorting and summarizing these 
error statistics by tape volume (or tape unit), operations personnel can identify 
volumes that might need reconditioning or replacement, or point out tape drives 
that might require cleaning or maintenance. 





1-10 System Management Facilities (SMF) 


























Analyzing the Configuration 


SMF generates records describing changes in the system configuration: 
e At IPL for online devices and MSS units (types 0, 8, 19, and 22) 

e@ When a device is added to the configuration (type 9) 

e@ When a device is removed from the configuration (type 11) 

@ 


When a CPU, channel path, storage, or MSS device moves online or offline 


(type 22) 


_In addition to these records, operations management can use specific information in 


other SMF records to report configuration statistics. The examples that follow 
show this use of SMF. 


Device and Channel Loading — From SMF records, an installation can obtain the 
total problem program EXCP counts by device and by channel over a given 
reporting period. (See Chapter 8 for a detailed explanation of EXCP counts and | 
the SMF record types that record them.) While this summary does not provide a 
true picture of the I/O load distribution, it might be helpful in identifying a gross 
loading imbalance among various devices or channels. 


Concurrent Device Usage — An installation can combine the data in the SMF step 
termination records to report the number of devices per device type that problem 
programs used during specified intervals. By using this report with the device 
activity records (type 74), an installation can identify periods of the day when the 
percentage of problem-program device usage was exceptionally high or low. 
Further evaluation might also show the cause of concurrent device usage. If, for 
example, no more than 12 of the available 16 tape drives are ever in use at the same 
time, any of the following situations might be responsible: 


e@ Job classes are conflicting. 


-@ Too few initiators are started. 


Scheduling Jobs 


Through the use of SMF data, it is possible to identify specific intervals when the 
problem program use of system resources is at an extremely high or low level. By 
studying the trends in this SMF data, and the relationships among the trends, 
operations management can establish and enforce its job scheduling procedures. 
The following examples describe a few potentially useful SMF data-trend analyses 
for scheduling jobs. 


Concurrent Job Activity — The SMF job initiation and termination records 


contain the start and stop times of each batch job, job step, TSO session, and started 


task. Using these times, an installation can determine the jobs that are executing 
during the same interval. From a scheduling point of view, a low number of 
concurrent jobs might indicate the need for establishing more job classes or using 
more initiators. 
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Job Wait Time in Initiation and SYSIN/SYSOUT Queues — The SMF step ey 
termination records have the following three time stamps: step initiation time, 

device allocation start time, and problem program start time. By calculating the 

differences in these three times, an installation can identify any abnormally long 

job step initiation. 


In addition, an installation can use the SMF output writer and job purge records 
to track job wait times in both the SYSIN and SYSOUT queues over a given period 
of time. If the resulting pattern of wait times shows any significant variances, the 
installation might want to further investigate the problem areas and perhaps 
alleviate them by rescheduling manpower or changing hardware. 


Job Throughput and Turnaround Time — By examining the SMF-recorded job 
accounting fields (such as department number, project number, and userid), as 
well as the SMF-recorded job initiation time and date fields, an installation can 
create a fairly accurate picture of its job throughput and turnaround time. For 
instance, one installation might analyze its throughput by calculating the total 
number of jobs initiated within each 15 minute interval and categorizing its jobs 
into test and production jobs. | 


Such an installation could also use SMF to determine the time of day when the 
largest number of production jobs were going through the system. By then limiting 
the number of test jobs during that time, the installation might improve its produc- 
tion turnaround time. 


Workload Characteristics — SMF provides job and job step information such as: ey 
Job/step name 
CPU time 
Elapsed (turnaround) time 
Address space dispatching priority 
JES2/JES3 job selection priority 
JES3 deadline type 
- Service units 


Performance group number 


By summarizing this type of SMF information for all jobs and job steps over a given 
period of time, an installation can establish its workload characteristics and set 
specific standards for each job class and priority. An installation can also use this 
information to determine whether its service goals are being met for specific 
combinations of job class, priority, performance group, and JES3 deadline type. 
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é | Summarizing Direct Access Volume Activity 


SMF reports a great deal of information about problem-program use of direct 
access volumes. The examples that follow illustrate how operations personnel can 
use this SMF information to examine problem-program use of direct access storage. 


Allocated But Unused Direct Access Storage — Many times users make allocation 
requests for direct access storage that are far in excess of the actual requirement. 
This misuse can be a significant drain on the direct access resource pool. In order 
to determine the number of tracks that were allocated for sequential data sets but 
were not used, an installation can compare the following two fields in the SMF type 
15 records: 


@ The relative track of the last record written (in the DASD extension of the 
DCB/DEB section) 


e The total number of tracks allocated (in the DASD extension of the UCB 
section): 7 | 


Volume Mounting — SMF writes a type 19 record whenever a volume that is 
defined by a DD statement is demounted. By summarizing these records by 
volume, an installation can obtain some indication of its direct access volume 
mounting activity for problem programs. 


In addition, an installation can use the SMF type 25 records to summarize the 
: JES3 volume mounting for problem programs. (JES3 produces a type 25 record 
( : for each job that main device scheduling (MDS) processes.) These records show 
: both the number of tape volumes and the number of disk volumes mounted for a 
job. 


Fragmented Volumes — Periodic analysis of the type 19 records can be useful in 
identifying direct access volumes whose unallocated space is fragmented. An 
installation can identify the volumes that might need reorganization by examining 
the relationship of the following SMF fields: 


e The number of unallocated cylinders and tracks 
e The number of cylinders and tracks in the largest unallocated extent 


-@ The number of unallocated extents 


An installation can further analyze the unallocated space on direct access 
volumes by comparing the number of unallocated tracks with the number of 
available DSCBs. For example, such a comparison might show that even though a 
given volume still has 50 free tracks, its amount of additional space is limited 
because there is only one available DSCB. 
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Evaluating Data Set Activity " 


SMF produces several records that contain information on data set activity (such 
as types 4, 14, 15, 17, 18, and =): These SMF records can assist an’ installation 


in answering questions such as: 
What is the average data set size for both tape and direct access devices ? 
Is the number of multi-volume data sets significantly large ? 
What percentage of all data sets is permanent ? What percentage is temporary ? 
What percentage of all temporary data sets does VIO control ? 
Which data sets do problem programs use most frequently ? 


How often do problem programs reuse permenent data sets ? 


What is the average blocksize, block count, and EXCP count for each tape 
data set ? 


@ How are problem programs using chained scheduling ? 


The following examples show different ways of evaluating problem-program data 
set activity from SMF records. 


Multiple Extents — By checking the “number of extents’’ field in the UCB section 
of the SMF type 14 and 15 records, an installation can identify direct access data 
sets that have exceeded their primary allocation and have used secondary 
allocation. Although useful, secondary allocation might affect system performance 
as well as fragment the space on direct access volumes. Thus, an installation 
detecting a significant amount of secondary allocation activity might want to sw 
consider using VIO. 


ae 


Data Set Modifications — SMF generates a record each time a user: 

@ Scratches a non-VSAM data set (type 17) 

@ Renames a non-VSAM data set (type 18) 

Defines an Integrated Catalog Facility (ICF) catalog entry (type 61) 
Deletes an Integrated Catalog Facility (ICF) catalog entry (type 65) 
Alters or renames an Integrated Catalog Facility catalog entry (type 66) 
Defines or alters a VSAM catalog entry (type 63) 

Deletes a VSAM catalog entry (type 67) 

Renames a VSAM catalog entry (type 68) 


By sorting these records by job name or userid, an installation can produce a 
report of the data sets that were defined, modified, or deleted by problem 
programs during a specified interval. Such a report might be useful in a backup 
situation, especially when critical data sets have been unintentionally altered or 
destroyed. . 


Open/Close Activity — SMF writes a type 14 or 15 record whenever a data set is 
closed or processed by EOV. An installation can determine how many of these 
SMF record types were written for a given data set. The number of type 14 and 
15 records can then be used to represent the number of times that the data set 
was closed or processed by EOV. (For this kind of report, an installation might 
want to exclude any SMF records for programs such as sorts, where it is known 
in advance that the open/close activity is significant.) 
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Blocking Factors — By examining the “blocksize” and “logical record length” 
fields recorded in the SMF type 14 and 15 records, an installation can identify 
those data sets that the system is processing with ineffective blocking factors. 

For instance, assume a data set having 10,000 records is processed unblocked with 
a logical record length of 80 using a 2314 device. An installation discovering such 
a data set through SMF might increase its blocksize to 1680 (21 records) to 
minimize I/O processing overhead and reduce direct access storage requirements. 


Optional Services — Although useful, some optional services might hinder system 
performance if not used appropriately. For example, the write validity check 
(OPTCD=W) service requires an additional disk rotation to reread the data written 
for each output block. Similarly, a data set that over uses the chained scheduling 
(OPTCD=C) service might monopolize the available time on a channel. An 
installation can use the SMF type 14 and 15 records to ensure that each 
application that uses an optional service is authorized or justified in using it. 


Profiling System Resource Usage 


All SMF records contain general identification fields such as the job name, step 
name, programmer name, reader start time, and reader start date. By sorting and 
summarizing SMF data according to these types of fields, an installation can create 
reports or profiles that show each batch job, job step, and TSO session’s use of 
system resources such as: 


CPU time 
Storage 

Paging facilities 
I/O devices 


Service units 


Programming languages 


CPU Time Usage — SMF accumulates the job/step CPU time in two separate fields 
of each job/step termination record: execution time under TCBs and execution 
time under SRBs. (See Chapter 9 for a list of the different times that are 

included and those that are excluded for these CPU-time fields.) An installation 
might want to summarize these time fields by program name over a given interval 
to compare each program’s SRB time with its total CPU time. This might identify 
programs that have excessive interrupt processing. 
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In addition to CPU time, SMF reports many different times relating to job, job 
step, and TSO session processing. For example, SMF records the following time 
Statistics: 


e@ Job/step/TSO session start and stop times 
_ Job/step/TSO session elapsed (turnaround) time 
Device allocation start time 
Problem program start time 
Initiator selection time 
TSO logon enqueue time 
_ Reader start and stop times 
Converter start and stop times 


Execution processor start and stop times 


Output processor start and stop times 


By examining these SMF-recorded time fields, an installation can profile each job’s 
flow through the system. Such a profile might identify jobs that have abnormally 
long wait times. These jobs are usually good candidates for further detailed 
examination. An installation might also want to use these time fields to determine. 
which jobs are running on the system at the same time or what the average turn- 
around time is for all TSO sessions. 


Storage Usage and Paging Activity — The SMF paging activity record (type 71) 
contains information about the demands made on the system paging facilities and 
the use of real and auxiliary storage. This record is written for specified measure- 


ment intervals and includes information such as the number of: 


Non-VIO page-ins and page-outs 
Non-VIO page reclaims 
Swap-ins and swap-outs 
Address space swap sequences 


VIO page-ins and page-outs 


VIO page reclaims 


An installation can calculate the system paging rate for each specified interval by 
dividing the number of page-ins and page-outs by the interval’s CPU time. By then 
plotting several paging rates over a long period of time, an installation can develop a 


correlation between its workload and real storage capacity. 
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SMF also reports the following information on storage usage and paging activity 
for each job step and TSO session: 


e Amount of contiguous real storage reserved for a program specifying 
ADDRSPC=REAL 


e Storage used from the top of the private area (includes the LSQA and the SWA) 


e Storage used from the bottom of the private area (includes subpools 0-127, 
251, and 252) 


Number of non-VIO page-ins and page-outs 
Number of swap-ins and swap-outs 


Number of address space swap sequences 


Number of VIO page-ins and page-outs 


An installation can use the SMF field “storage used from the bottom of the 
private area”, along with the paging statistics for the address space, to estimate a 
job’s use of real storage. 


I/O Activity — Several SMF records contain useful information about a job, job 
step, or TSO session’s I/O activity. For example, the step termination records 
contain device entries that include the device class, unit type, channel/unit address, 
and EXCP count. An installation might want to use these SMF fields to isolate 
those job steps whose I/O activity exceeded certain limits, for example:. 


e@ More than a given percentage of the I/O activity was on a certain unit. 
e More than a given percentage of the I/O activity was on a certain shannel path. 


@ More than a given number of data sets on the same direct access volume each 
had a significantly large number of EXCPs. 


Service Activity — An installation can use the SMF termination records to report 
the number of service units, transaction active time, and performance group 
number for each job step and TSO session. By comparing this information with the 
information reported in the RMF workload records (type 72), an installation can 
calculate the percentage of the total system services that is given to particular 
performance groups. Such a comparison might be helpful in determining whether 
service is being distributed according to the goals of the installation. (See 
Initialization and Tuning for more information on service, transaction active time, 
and performance group numbers.) 


Programming Language Usage — The SMF type 4, 30, and 34 records contain 
the name of the program used (taken from the PGM= parameter on the EXEC 
statement). By sorting these records by program name, an installation can 
determine to what extent users are compiling in various programming languages, 
such as PL/1, COBOL, and FORTRAN. 


Similarly , an installation can produce reports for specific job categories or 
installation departments by using key program names such as SORTJOBS, 
PAYROLL, and STANDRDS. By assigning unique step names (using the ACCT= 
parameter on the EXEC statement) and evaluating the SMF step termination 
records (which report those names), an installation can also produce reports for 
each step in a cataloged procedure. 
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( Chapter 2: System Requirements and Considerations 


To record SMF data, an installation must define how it will use SMF (see the chapter 
“Defining the Use of SMF’), add user-written exit routines to the control program, 
allocate direct access space for the SMF data sets, and catalog the SMF data sets. 
This chapter describes these requirements as well as SMF storage requirements and 
performance considerations. 


Including User-Written Exit Routines In The Operating System 


User-written exit routines are optional — SMF automatically provides dummy 
routines for all unused SMF exits. To include user-written exit routines in the 
Operating system, you can add them to the appropriate distribution libraries before 
SYSGEN, or link-edit them into their load modules in SYS1.LPALIB after 
SYSGEN. When link-edited after SYSGEN, the modules are not available for 

use until the next IPL with the CLPA option. 


Figure 2-1 shows the distribution libraries to use to add exit routines prior to 
SYSGEN. It also shows the load module assignments to use to add exit routines 
after SYSGEN. When adding exit routines after SYSGEN, refer to your SYSGEN 
listing for exact load module names, aliases, link-edit control statements, and link- 
( . edit parameters. Specify link-edit parameters according to the characteristics of the 


user-written exit routines. 
Written Exit Routine Routine to SYS1.LPALIB 


Descriptive Name | before SYSGEN! after SYSGEN 


IEFUJV Job Validation SYS1.AOSB3 lEFUJV | 















Load Madule Assignment 
for Adding User-Written Exit 


Distribution Library 
for Adding User- 




















[ers [swoinnanon | everacsea [eu 


1IEFU83 SVC Entry SYS1.A0S00 1EFU83 | 
SMF Record 

IEFU84 Branch Entry SYS1.AQOS00 IEFU84 
SMF Record 


| 1eFUuP SYS1.ALPALIB lEFUJP 
1EFU29 SMF Dump | SYS1.A0S00 [EFU29 | 


1User-written exit routines to be added before SYSGEN must be in load module format. 













Figure 2-1. Including User-Written Exit Routines in the Operating System 


Chapter 2: System Requirements and Considerations 2-1 























Figure 2-2 shows sample JCL for adding user-written exit routines to fo 
SYS1.LPALIB after SYSGEN. Note that when user-written exit routines become WY 
part of SYS1.LPALIB they do not become active until the next IPL of the system 
that includes the CLPA option. 


Note: Refer to your SYSGEN listing for exact load module names, aliases, link- 
edit control statements, and link-edit parameters. Specify link-edit parameters 
according to the characteristics of the user-written exit routines. 


/[LINKEXIT JOB  MSGLEVEL=!1 

//STEP1 EXEC PGM=IEWL,PARM=‘link-edit parameters’ 
//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DISP=(OLD,KEEP),DSN=SYS1.LPALIB 


//SYSUT1 DD UNIT=SYSDA,DISP=(,DELETE), 
SPACE=(TRK,(20,5)) . 
//SYSLIN DD * 
(IEFUJSV object deck) 
ENTRY IEFUJV 
NAME IEFUJV(R) 
(IEFACTRT object deck) 
INCLUDE  SYSLMOD(IEFACTRT) 
ENTRY IEFACTRT 
NAME IEFACTRT(R) 
(IEFUII object deck) —_ 
ENTRY IEFUII ed 
NAME IEFUSJI(R) 
(IEFUSI object deck) 
ENTRY IEFUSI 
NAME IEFUSI(R) 

‘(IEFUTL object deck) | 
ENTRY IEFUTL | 
NAME IEFUTL({R) 

(IEFU84 object deck) 
ENTRY IEFU84 
NAME IEFU84(R) 

(IEFUSO object deck) 
ENTRY IEFUSO 
NAME IEFUSO(R) 

(IEFU83 object deck) 
ENTRY IEFU83 
NAME IEFU83(R) 

(IEFUJP object deck) 
ENTRY IEFUJP 
NAME IEFUJP(R) 

/* | 








Figure 2-2. Sample JCL for Adding User-Written Exit Routines to SYS1.LPALIB after SYSGEN 
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( ’ SMF Buffers 


Each buffer consists of 4096 byts plus 24 additional bytes of buffer control 
information that is not written to the data set. The number of buffers available is 
limited only by the amount of virtual storage in the MSF address space below 16 
megabytes. At initialization, SMF obtains 10 permanent and 200 temporary buffers. 
SMF obtains and releases more buffers as SMF activity increases and decreases in 
order to keep real storage use to a minimum. 


SMF Data Sets 


You can allocate space for up to 36 SMF data sets. These data sets should be 


password or RACF protected. The space must be allocated using the 
DEFINE access methods services utility or at system generation time using the 


DATASET macro instruction. 


The primary data set is the data set normally used for SMF recording; the 
secondary data sets are used when the primary one is full. The SMF data set sel- 
ection algorithms expect the primary data set to be allocated on a high performance 
device and the secondary data sets to be allocated where space is available. Primary 
and secondary data sets are designated using the DSNAME parameter in 
SMFPRMxx, where the first data set specified is the primary and all others are 
secondary. Each data set must be a VSAM data set that resides on a single volume 
and is cataloged and not extendable; do not specify secondary allocations for 
RECORDS, TRACKS, or CYLINDERS. 


( | SMF data sets allocated with the DEFINE utility require the following options: 
e@ Reuse (EUS) indicates that the data set can be cleared by the dump program. 
e Control interval size (CISZ) indicates the size of the SMF buffer. (This value 
must be 4096). 


e Record size (RECSZ) indicates the average and maximum logical record size. 
(This value must be 4086 32767). 


e Share options (SHR) indicates that sharing occurs with reading and serialization 
occurs with writing. (This value must be 2). 


@ Non-indexed (NIXD) indicates that the entries are entry sequenced. 
e@ Spanned (SPND) indicates that the records can span control intervals. 


e@ Speed (SPEED) indicates that the dataset will not be preformatted by VSAM 
while IFASMFDP is preformatting. 


For more information on the DEFINE utility see Access Method Services. Several 
factors, such as specific system configuration, amount of SMF data to be written, 
and report program requirements, will determine which device type is most efficient 
for a particular installation. 


Note: If DB2 Performance, Serviceability, or Audit Data is sent to SMF, CIS2 
(4096) and BUFSP (81920) must be specified for each SMF VSAM Dataset on 
MVS/XA. 
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Figure 2-3 illustrates the JCL statements needed to use the DEFINE utility to 
allocate one SMF data set on a direct access device and catalog it in the system 
catalog. This figure assumes that the VSAM data space already exists and that 
an IPL with the NOACTIVE SMF parameter was performed. Each SMF data set 
must be created according to this example before the first IPL that starts SMF 
recording. The second step in this example preformats the data set. If the pre- 
formatting is not done during the definition process, SMF initialization preformats 
the data set. In either case, SMF preformats the data set with dummy records. 
To avoid increasing the time required to IPL the system, it is recommended that the 
installation use the SMF dump program, IFASMFDP, to preformat the data sets. 
When the SMF dump program dumps the data set at a later time, it does not read 
to the physical end of file on a partially full data set. SMF recognizes the first 
dummy record and terminates processing. 





//ICREATE JOB 

/I(CREATE EXEC PGM=IDCAMS 

//SYSPRINT DD SYSOUT=A 

/ISYSIN DD * 

DEFINE CLUSTER (NAME (SYS1.MANX) + 

VOLUME (xxxxxx) + 
NONINDEXED + 
CYLINDERS(nn) + 
REUSE + 
RECORDSIZE(4086,32767) + 
SPANNED + 
SPEED + 
CONTROLINTERVALSIZE (4096) + 
SHAREOPTIONS(2)) 

/* 

/[/FORMAT EXEC PGM=IFASMFDP 

/ISYSPRINT DD SYSOUT=A 

/INEWDS DD DSN=SYS1.MANX,DISP=SHR 

//SYSIN DD * 

INDD(NEWDS,OPTIONS(CLEAR)) 
/* 





Figure 2-3. Sample DD Statements for Allocating and Cataloging the SMF Data Sets 


When an SMF data set is defined at system generation time using the 
DATASET macro instruction, space is allocated and the data set is catalogued. 
However, the data set is not preformatted. If an Integrated Catalog Facility catalog 
is defined via the sysgen process all define space statements must be removed if 
also defining SMF. 


For more information on using the DATASET macro instruction, see System 
Generation Reference. 
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Regardless of how the data sets are allocated, the amount of DASD space 
required for the SMF data sets depends on the amount of data generated and how 
often the data sets are dumped. The amount of data generated depends on the 
system work load and the record types selected for writing to the SMF data set. 

If SMF data is available from a system similar to your own, you can use the report 
produced by the SMF dump program to estimate the amount of data generated. 
Otherwise, it may be necessary to select a trial size for the data sets and adjust it 
as necessary. 


For example, you might start with two SMF data sets, each allocating 25 cylin- 
ders of space on a 3330. If the data sets fill up too quickly and data is lost, you 
can allocate more space for each data set, or allocate additional data sets. If DASD 
space is severely limited in your installation, you might have to dump the data 
sets more frequently. 
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Dumping The SMF Data Sets 


When the current recording data set cannot accomodate any more records, the SMF 
writer routine automatically switches recording from the active SMF data set to an 
empty SMF data set, and passes control to the SMF dump exit, IEFU29. The 
operator is then informed that the data set needs to be dumped. (For information on 
the IEFU29 exit, see the chapter “User-Written Exit Routines’.) The operator 
should use the SMF dump program, IFASMFDP, to transfer a full SMF data set to 
another data set, and to reset the status of the dumped data set to empty so that it 
can be used again for recording data. For those installations choosing to read the 
SMF data sets directly rather than using the dump program, note that the SMF 

data sets are preformatted with dummy records. A dummy record is shorter than 
any valid SMF record and is easily identified because it contains the characters 
“SMFEOFMARK’. The SMF dump program terminates processing when it 
encounters a dummy record, thereby improving data set processing performance. 


Note that programs that access the output of the SMF dump program are required 
to specify the correct LRECL value. Failure to specify a large enough LRECL value 
might result in an 002 abend. The LRECL value must equal the length of the longest 
SMF record being created plus four bytes for the RDW. The LRECL value can be 
larger than the BLKSIZE value because the records can be segmented. 


The SMF dump program IFASMFDP, allows multiple, VSAM or QSAM data sets 
to be dumped to one or more sequential data sets on either tape or direct access 
devices. Also, IFASMFDP allows the installation to route different records to 
separate files and produce a summary activity report. This report is described later 


in “The Summary Activity Report.” 


The installation can also specify three 24-bit addressable user exit routines to 
be given control during the dump processing. These exit routines allow the user 
to examine or modify the record before it is written. When each exit is invoked, 
register 1 contains the address of a three-word parameter list (Figure 2-4). The 
first word is the address of a three-word user work area. The contents of the user 


work area are: 


word 1 — register 0 on entry to IFASMFDP 
word 2 — register 1 on entry to IFASMFDP 
word 3 — reserved for user. This word is initialized to zero before the first user 


exit is invoked. 


The contents of the second and third words depends on the user exit being invoked. 
The user exits are described in “The SMF Dump Options.” 


‘Three-word user exit parameter list 


user _—s« fuser 
exit exit 
data data | 











Three-word user exit work area _ 


[re [rns Jom 


Figure 2-4, IFASMFDP Input Parameter Structure 
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— : The SMF dump program copies the input data sets to the output data sets. During 
( the copy process, the dump program creates two SMF records and writes them to 
each output data set: a dump header (record type 2) at the beginning of the data 
set and a dump trailer (record type 3) at the end of the data set. 


The SMF dump program also writes messages, as required, to SYSOUT: 


e@ The operator must not clear a data set that is being filled. If the operator 
attempts to clear the active SMF data set, IFASMFDP returns a code of X‘08’ 


in register 15. The operator can, however, dump the active or alternate data set 
without clearing it. 


e If IFASMFDP is unable to open either the input or output data sets, it writes 
an error message indicating which data set was not successfully opened. 


e If all SMF data sets and the SMF buffers become full, SMF will be in a data lost 
condition (unable to record) until dumping takes place. When this condition 
occurs, the number of lost records is tracked in SMF record type 7 and the 
operator receives a message stating that data is being lost. 


Switching The SMF Data Sets 


To prepare an SMF data set for dumping before it becomes full the operator can. 
use the HALT EOD and SWITCH SMF commands. (These operator commands 
are fully described in System Commands). 


When the operator issues either the HALT EOD or the SWITCH SMF command, 
the following actions occur: 


( @ Atype 19 record is created for each online direct access device if a type 19 
record was specified. 


@ Fora SWITCH SMF command, a type 90 record is created to show the old 
and new data set names. 


@ The SMF buffer is written to the active SMF data set. 


e The SMF data sets are switched so that the operator can dump the previously 
active data set. 


Note: When switching the SMF data sets, an inactive data set cannot become 
active unless it is empty. Therefore, the operator should use the DISPLAY SMF 
command to verify that there is at least one alternate data set before issuing the 
HALT or SWITCH command. 


Note: In the event that multiple switch SMF commands are issued with no 
intervening dump of an SMF data set completing its function, the status of the 
SMF function is not completely predictable. Minimal impact would be a data 
loss condition. Other potential impacts are: a) neither SMF data set may return 
to an available recording state, b) a data set may appear to be recording due to 
output of MSGIEE3601, but data may not be getting processed to it, resulting 
in a data loss condition and, c) the data set that was switched from last may 
become the current data set. 
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Performance Considerations 


SMF will reduce system throughput by various amounts depending upon factors 


~ such as: : 


SMF options selected through the SMFPRMxx parameters. (For a description 
of these parameters, see the chapter “Defining the Use of SMF’’.) 


SMF data set size, device type, and dumping requirements. 


Execution time of user-written exit routines. 
System configuration, especially the type and degree of multiprogramming. 


Processing characteristics, such as the number of jobs (the number of records 
generated by SMF depends on the number of jobs), the contention for SMF 
resources, and user data set requirements. 


Specific record type chosen to be recorded. 


Note that record types can be suppressed, as described under “Defining the 
Use of SMF”’. | 





























Defining the Use of the SMF Dump Program 


This section describes the SMF dump program, IFASMFDP. Included in this 
section are: 


@ The SMF dump options 
e Executing the SMF dump program 


e The summary activity report 


The SMF Dump Options 


The IFASMFDP parameters control the processing of the dump program. The 
parameters are: 


INDD(ddname,OPTIONS(data)) 






Meaning and Use 















Describes the input data set, where ddname is the DONAME of. the data set and data can 
be any one of the following: 
@ DUMP indicates that the input data set is to be read or copied without being reset. 
e CLEAR indicates that the input data set is to be reset and preformatted. 
The information on the data set is not copied and therefore lost. 
e ALL indicates both the DUMP and CLEAR options. 


if INDD is not specified the default is: 
INDD(DUMPIN,OPTIONS(ALL)) 


If DUMP or ALL is specified, a summary activity report is written if at least one record 
was read or written. For more information, see ‘Summary Activity Report.” 









Describes the output data set, where ddname is the DONAME of the output data set. TYPE 
indicates that the record types and subtypes specified in list are to be included in the data set. 
NOT YPE indicates that all record types and subtypes except those specified in list are to be 
included in the data set. List can be any record type and subtype or combination of records; 
the record types and subtypes can be specified individually or as a range. For example, 
TYPE(2,4:7,9,30(2,4:6)) indicates that records 2, 4, 5,6, 7,9, and subtypes 2, 4, 5, and 6 of 
the type 30 record are to be included in the data set. NOTYPE(30(1,3:5)) indicates that 
subtypes 1, 3,4, and 5 of record type 30 will not be recorded. 


If OUTDD is not specified the default is: 
OUTDD(DUMPOUT(TYPE(000:255)) in which all types and subtypes are included in the 
data set. é 


TYPE . 
OUTDD(ddname, ‘i aa list)) 





If both TYPE and NOTYPE are specified for the sarne data set, the first valid specification 
is used. If a syntax error occurs in the OUTDD option and any INDD option specified ALL 
or CLEAR, the job is terminated. 

DATE(yyddd,yyddd) Specifies the start and end date for the period for which records are to be written, where 
vy is the last two digits of the year and ddd is the Julian date. The value for ddd can not | 
exceed 366. If only one date is requested, the start and end dates are the same. If two 
dates are specified, only those records written on or between the two dates are written. 


if DATE is not specified the default is: 
DATE (00000,99366) 


START(hhmm) Specifies that only those records that were recorded after the START time and before 
the END time are to be written, where hh is the hours and mm is the minutes, based on a 
24-hour clock. 

If START is not specified the default is: 
START(0000) 


Specifies that only those records that were recorded after the START time and before the 
END time are to be written, where hh is the hours and mm is the minutes, based on a 
24-hour clock. 


| If END is not specified, the default is: 
END(2400) 
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| ie 
Parameter ,o ve Meaning and Use ed 


Specifies that only records written by the operating system with the specified system 
identifier can be written to the output data set, where cccc is the system identifier. S!1D 
can be specified for each system the dump program is expected to handle. If SID is not 
specified, records pertaining to any operating system are written. 










USER 1(name) Specifies the name of a user-written exit that is given control after each record is read and 
the counters incremented. The parameter list pointed to by register 1 contains the address 
of the three-word user work area in word 1, the address of the SMF record in word 2, and 
the address of the INDD ddname in word 3. 


The user exit routine must set a return code in register 15 before passing control back to 
the dump program. The return codes are as follows: 


Code Meaning 
00 Indicates that normal processing should continue. 
04 Indicates that the record should not be written to the output data set. 


Any other return code indicates that a problem was encountered and that the dump program 
is not to invoke the exit again. 


Specifies the name of the user-written exit routine that is given control only when the 
dump program selects a record to be written. The parameter list pointed to by register 1 
contains the address of the three-word user work area in word 1, the address of the SMF 
record in word 2, and the address of the OUTDD ddname in word 3. This exit is always 
called by the dump program before any records are read. 


USER2(name) 


The return codes are the same as those for USER1. 








Specifies the name of the user-written exit routine that is given control after the output 
data set is closed. This routine is invoked for each output data set. The parameter list 
pointed to by register 1 contains the address of the three-word user work area in word 1, 
the address of the output DCB in word 2, and the address of the OUTDD ddname in word 
3: 


The user exit routine must set a return code in register 15 before passing control back to the 
dump program. The return codes for USER3 are as follows: 
0 indicates that normal processing should continue. 


Any non-zero return code indicates that a problem was encountered and that the dump 
program is not to invoke the exit again. 











Notes: 

1. If a syntax error occurs in the processing of a parameter, the parameter is 
not processed and a message is printed in the SYSPRINT data set. Ifa 
parameter is not specified, the default is used. The valid dump parameters 
specified or used by default are listed in the SYSPRINT data set on com- 
pletion of the dump program. 


2. The name field in USER1, USER2, or USER3 specifies the name of a load 
module which IFASMFDP LOADs and CALLs at the indicated times. Each 
exit should be link edited into an APF-authorized library but the exit should 
not be link edited with the AC=1 attribute. 


3. If the start time is less than the end time, the records selected for any 
particular day are those records produced after the start time and before the 
end time. For example, if you specify: 


START(0800),END(2000) 
SMF selects records during the period indicated by the shaded area: 
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If the start time is greater than the end time, all records produced between 
the start time and the end time on the following day are selected. For 
example, if you specify: 


START(2000),END(0800) 
SMF selects records during the time period indicated by the shaded area: 


2400 0800 2400 0800 2400 0800 2400 





Note that the records produced between 0800 hours and 2000 hours in any 
day are not selected. 


4. User records must include a standard record header; the IFASMFDP program 
might not dump or flag in error a record that does not have a standard header. 


Executing the SMF Dump Program 


Figure 2-5 shows sample JCL for executing the SMF dump program (IFASMFDP). 
The output is a non-temporary data set on a standard-labeled tape. The operator 
should record the volume serial number of the output data set so that other jobs 
can reference it. Note that it is not necessary to specify the DCB=keyword. The 
dump program assigns the following DCB attributes: 

e BLKSIZE=4096 

e LRECL=32767 


@ RECFM=VBS 





/IDUMPX JOB  MSGLEVEL=1 
HISTEP1 EXEC PGM=IFASMFDP 
/IOUMPIN DD  DSN=SYS1.MAN a7 DISP=SHR 


/IDUMPOUT DD DSN=SMFDATA,UNIT=tapeaddr, 
iL DISP=(NEW,KEEP),LABEL=(,SL),VOL=SER=serial 
/ISYSPRINT DO SYSOUT=A 


Figure 2-5. Sample JCL for Executing the SMF Dump Program 
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Figure 2-6 illustrates a sample job using the IFASMFDP to dump and clear an 
_ SMF data set INDD1) and to combine its records with those in an old dumped 
file (INDD2) to two online data sets. 


There can be any number of input (INDD) or output (OUTDD) files in the 
dump program. The input files are dumped in reverse order unless concatenated 
under one input file. For example, in Figure 2-6, two input files are specified. . 
After the dump program is executed, the output file contains the records from 
INDD2 first, followed by the records from INDD1. 





/I1FASMFEDP. JOB __ accounting information 
/ISTEP EXEC PGM=IFASMFDP 
/IINDD1 DD DSN=SYS1.MANB,DISP=SHR : 
/ANDD2 DD DSN=SMFDATA,UNIT=TAPE,DISP=SHR,VOL=SER=SMFTAP 
//OUTDD1 DD DSN=ALLSMF.TYPEO.TYPE40,DISP=SHR 
/OUTDD2 DD DSN=ALLSMF.TYPE10.TYPE255,DISP=SHR 
HISYSPRINT DD SYSOUT=A 
LHISYSIN DD * 
INDD(INDD1,OPTIONS(ALL)) 
INDOD(INDD2,OPTIONS(DUMP)) 
OUTDD(OUTDD1,TYPE(0,2,10,15:40)) 
OUTDD(OUTDD2,TYPE(10:255)) 
DATE(82002,82366) 
S$1D(308A) 
$!1D(308B) 


/* 





Figure 2-6. Sample Job for Dumping SMF Data Sets 


After the IFASMFDP job shown in Figure 2-6 executes, the following information | 
is listed in the SYSPRINT data set. 


SMF DUMP PARAMETERS 

SID(308A) — SYSIN 

S1D(308B) — SYSIN 

END(2400) — DEFAULT 

START(0000) — DEFAULT 

DATE(82002,82366) — SYSIN 
OUTDD(OUTDD2,TYPE(10:255)) — SYSIN 
OUTDD(OUTDD1,TYPE(0,2,10,15:40)) — SYSIN 
INDD(INDD2,OPTIONS(DUMP)) — SYSIN 
INDD(INDD1,OPTIONS(ALL)) — SYSIN 


One method of executing the SMF dump program is to enter jobs that specify 
the program into the system, and hold them on the job queue until a dump is 
required. Another method isto start a reader to an input stream containing the. 
JCL for the SMF dump program. Figure 2-7 illustrates two sample procedures 
(DUMPX and DUMPY) for dumping the SMF data sets to a standard-labeled tape 
(VOL=SER=SMFTAP) by means of the operator START command. In both 
procedures, the default tape specified on the PROC statement is 192. Figure 2-7 
also illustrates sample JCL for adding these procedures to SYS1 .PROCLIB. 
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/(UPDATE JOB MSGLEVEL=1 

/[UPDATE EXEC PGM=!EBUPDTE,PARM=NEW 

/ISYSUT1 DD DSN=SYS1.PROCLIB,DISP=SHR 

/ISYSUT2 DD DSN=SYS1.PROCLIB,DISP=SHR 

/ISYSPRINT DD SYSOUT=A 

IISYSIN DD DATA 

/ ADD NAME=DUMPX,LIST=ALL 

//DUMPX PROC TAPE=192 

/ISMFDMP EXEC PGM=iFASMFDP 

/(DUMPIN DD DSNAME=SYS1.MANX,DISP=SHR 

/IDUMPOUT DD DSNAME=SMFDATA,UNIT=&TAPE,DISP=(MOD,KEEP), 
// LABEL=(,SL), VOL=SER=SMFTAP 

[ISYSPRINT DO SYSOUT=A 

/ ADD NAME=DUMPY,LIST=ALL 

//DUMPY PROC TAPE=192 

[ISMFDMP EXEC PGM=IFASMFDP 

//DUMPIN DD DSNAME=SYS1.MANY ,DISP=SHR 

/IDUMPOUT DD DSNAME=SMFDATA,UNIT=&TAPE,DISP=(MOD,KEEP), 


// LABEL=(,SL), VOL=SER=SMFTAP 
/ISYSPRINT DD SYSOUT=A 

./ENDUP 

/* 


Figure 2-7. Sample Procedures for Dumping the SMF Data Sets 


The CLEAR function of IFASMFDP requires APF-authorization. Executing 
the dump program as shown in the above JCL examples preserves the APF- 
authorization assigned to the program when link-edited by SYSGEN. Invoking 
IFASMFDP in any way other than as shown above (for example, invoking 
IFASMFDP from another program or invoking it as a TSO command), might 
cause it to lose its authorization. 


The DUMP function is permitted in an unauthorized environment. If the 


CLEAR function is attempted, a message is written indicating that the request was 
denied. | 


For more information on APF-authorization, see System Macros and Facilities. 
For more information on executing authorized programs under TSO, see TSO. 


The IFASMFDP dump utility also issues return codes. They are as follows: 


Code Meaning 


00 Indicates that the dump was successful; no errors were encountered. 

04 Indicates that the dump was successful; one or more errors were 
detected but processing continued. 

08 Indicates that the dump was not successful; an error terminated 
processing. 


Chapter 2: System Requirements and Considerations 2-13 








The Summary Activity Report 


The dump program creates a summary activity report when the DUMP option was 
specified for any of the input data sets and at least one record was read or written. 


Figure 2-8 shows an example of the summary activity report the dump program 
creates. The meaning of each heading is: 


e START DATE-TIME indicates the date and time of the earliest record read, 
excluding record types 2 and 3 and those greater than 127. 


END DATE-TIME indicates the date and time of the latest record read, 
excluding record types 2 and 3, and those greater than 127. 


e RECORD TYPE indicates the identifying number of each record type read by 
the dump program. 


@e RECORDS READ indicates the number of input records read for each record 
type. 


e PERCENT OF TOTAL indicates the number of records read for each type 
divided by the total number of records read. 


e AVG RECORD LENGTH, MIN RECORD LENGTH, and MAX RECORD 
LENGTH indicate, respectively, the average, minimum, and maximum lengths of oof; 

the records read for each record type. 

e RECORDS WRITTEN indicates the number of output records written to the 
output data sets for each record type. 


e TOTAL indicates the total activity for each column. 


e NUMBER OF RECORDS IN ERROR indicates the number of spanned records 
(a record that is larger than the 4K SMF buffer size) that were found in error. 
This can occur when a physical I/O error occurs on a recording data set, while 
a record longer than 4K is being written. RMF record types 74, 76, and 79 or 
SMF record type 30 can be longer than 4K. 





2-14 System Management Facilities (SMF) 














( | SUMMARY ACTIVITY REPORT 
START DATE-TIME 06/07/82 — 04:17:40 END DATE-TIME 06/07/85 — 23:29:02 


AVG. MIN. MAX. 
RECORD RECORDS PERCENT RECORD RECORD RECORD RECORDS 








Figure 2-8, Summary Activity Report Example 
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TYPE READ OF TOTAL LENGTH LENGTH LENGTH WRITTEN 
0 13 01% 35.00 35 35 13 
2 0 1 
3 0 1 
4 25,399 12.90 % 265.93 183 935 25,399 
5 5,084 2.58 % 161.92 130 186 5,084 
6 11,526 5.86 % 90.80 88 94 11,526 
g 60 03 % 24.40 24 32 60 
10 368 19 % 48.00 48 48 368 
11 331 17% 24.00 24 24 331 
19 2,483 1.26 % 68.00 68 68 2,483 
20 7,953 4.04 % 94.75 74 130 7,953 
21 3,115 1.58 % 48.00 48 48 3,115 
26 10,394 5.28 % 236.00 236 236 10,394 
31 23 01% 58.00 58 58 23 
34 2,604 1.32 % 436.64 183 1,055 2,604 
35 2,602 1.32 % 130.00 130 130 2,602 
40 107,178 54.45 % 84.36 74 882 107,178 
a 43 17 01% 32.00 32 32 17 
( 45 4 00 % 28.00 28 28 4 
47 75 04 % 54.53 52 90 75 
48 26 01 % 74.53 73 75 26 
70 360 18% 500.00 500 500 360 
71 359 18% 344.00 344 344 359 
72 4,308 2.19% 158.05 136 312 4,308 
73 360 18 % 795.30 660 916 360 
74 1,083 55% 5,662.60 148 8,128 1,083 
75 2,513 1.28 % 160.00 160 160 2,513 
170 7,689 3.91% 95.00 95 95 7,689 
248 790 40 % 86.00 86 86 790 
249 108 05 % 86.00 86 86 108 
TOTAL 196,825 100 % 159.00 24 8,128 196,827 
NUMBER OF RECORDS IN ERROR 0 
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Chapter 3: Defining The Use Of SMF 


An installation can define how it will use SMF through selecting SMF parameters. 
The parameters can be placed in a SYS1 .PARMLIB member SMFPRMx<x, or the 
installation can use the IBM-supplied values in SMFPRMOO or the SMF defaults. 
You can specify SMFPRMxx parameters: 


Before the first IPL of a newly generated system by adding SMFPRMxx as 
a member of SYS] .PARMLIB. 


At each initialization of SMF by entering the parameters at the console if 
PROMPT (LIST or ALL) is specified in the active SMF parmlib member. 


During execution of SMF by using the SET SMF operator command to specify 
a new SMFPRMxx member. 


During execution of SMF by using the SETSMF operator command to replace 
individual parameters in the SMFPRMxx member. 


Part I -- SMFPRMxx Parameters 


The possible SMFPRMxx parameters are described in Figure 3-1. 


Note: If you specify the same keyword more than once, SMF uses the first valid — 
specification read from the parmlib member, or the last one specified in an operator 
reply. 
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ACTIVE I N/A ACTIVE 
See 


NOACTIVE 
DSNAME (SYS1.MANX, 
SYS1.MANY) 













Specifies whether or not SMF recording is to be active. 














DSNAME (data set) | Specifies a list of up to 36 VSAM data sets that are to be 
used for SMF recording. Each data set must be named 


SYS1.MANn, where n can be any alphameric character. 


explanation 










The first data set specified is the primary SMF recording 
dataset. All other specified datasets are secondary data sets. 





















LISTDSN 
NOLISTDSN 


Specifies whether the system is to generate SMF data set N/A LISTDSN 
status Messages to the Operator at IPL or SET SMF time. 
The messages contain the following information for each 


data set used for recording: 


e data set name 
@ data set status 
— active 
— alternate 
— dump required 
@ data set size (in number of 4096-byte blocks) 
@ percentage full 












































SID (3081) 


The SID assigned is the 
four-digit processor 
model number taken 
from the PCCA control 
block. 






See 
explanation 


Specifies the system identifier to be used in all SMF records, 
where xxxx can be any four alphameric and/or special 
characters. 


(xxxx) 


oe ee (ser? ] t 












If you want to use one SMFPRMxx parmlib member for 
your entire installation, specify a SID parameter for each 
system and use the serial number subparameter on each 
SID parameter. SMF selects the SID with the serial 
number(s) that match the processor serial number(s) at IPL. 
The xxxx value associated with the serial number(s) will be 
the system identifier placed in each SMF record. 


For example, if SID(SYSA,006204) and 
S!ID(SYSB,006204,206204) are specified in the same 
parmlib member, and processor 006204 was IPLed as a 
uniprocessor, SID(SYSA,006204) applies. If the processor 
was IPLed as a multiprocessor, SID(SYSB,006204,206204) 
applies. 









Notes: 

1. The SID parameter cannot be changed by a SET SMF or 
a SETSMF command. 

2. Note that it is possible for an installation to have more 
than one processor (such as a 3081 and a 3083) with 
the same serial number. In such cases, use a separate 
SMFPRMxx parmlib member for each processor. Other- 
wise, SMF will select the system identifier that contains 

the first occurrence of the matching serial number, re- 

gardiess of the value specified for xxxx. 


N/A REC (PERM) 









Specifies whether information for record type 17 (scratch 
data set status) is to be collected for temporary data sets. 
PERM specifies that record type 17 is to be written only 

for non-temporary data sets. 


ALL specifies that record type 17 is to be written for 
both temporary and non-temporary data sets. 






Figure 3-1. SMFPRMxx Parameters (Part 1 of 4) 
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Meaning and Use Value Range Default Value 


MAXDORM (mmss) Specifies the amount of real time that SMF allows data 0001-5959 MAXDORM (3000) 
30 minutes 























ss is seconds. NOMAXDORM specifies that the data 
remains in the buffer until the buffer is full. 












STATUS (hhmmss) 
NOSTATUS 


Specifies the amount of real time between creations of 
record type 23 (SMF statistics) where hh is the hours, 
mm is the minutes, and ss is the seconds. 





NOMAXDORM to remain in an SMF buffer before it is written to a 
000001- STATUS (010000) 
240000 


recording data set, where mm is real time in minutes and 
1 hour 
0001-2400 







JWT (0010) 
10 minutes 


Specifies the maximum amount of time that a job is 
allowed to wait continuously, where hh is the amount of 
real time in hours and mm is in minutes. When the 
specified time limit has expired, the time limit exit, 
IEFUTL is entered (if active). 


Note: {f TIME=1440 is coded on the JOB or EXEC JCL 
statement, [EFUTL is not invoked for that job. 



















PROMPT (option) 
NOPROMPT 


Specifies whether the selected SMF parameters are to be N/A PROMPT (ALL) 
displayed on the system console at IPL time. The 
operator can be prompted for a reason for the IPL or to 


modify the parmlib parameters. The options are as follows: 


iPLR specifies that the operator is to supply a reason 
for the IPL. 

e LIST specifies that the operator can modify the SMF 
parameters. 

e ALLspecifies that the operator is prompted for the 

IPL reason and can modify the SMF parameters. 
















NOPROMPT specifies that the parameters are not listed 
and the operator is not prompted unless there is a syntax 
error in the parmlib member. 


NOPROMPT is the default if PROMPT is specified without 
an option. PROMPT(ALL,) is the default if no keyword is 
specified. 




























| See each 
option 


| Specifies the global recording options for the entire system. 
The options include the record types and subtypes to be 
collected, the real time intervals between recording, and the 
valid SMF exits. If the same option is specified more than 
once, the first valid specification read from the parmlib or 
the last one specified in a operator reply, is used. The 

| options are as follows: 


SYS (options) | See each option 






















0-255 when | type(0:255) 



















AA, BB\cc) no subtypes | (all subtypes) 
TYPE ( AA,BB:22 ) are specified 
NOTYPE AA.DD(cc:yy),... 
AA,BBicc,.. .) 0-127 when 


subtypes are 
specified 





TYPE specifies the record types and subtypes to be collected 
by SMF where AA, BB, DD, and ZZ are the decimal 
notations for each record. cc and yy are the decimal 
notations of the subtypes to be collected. A colon is used as 
as a delimiter to indicate that all records from BB up to and 
including ZZ are to be recorded and all subtypes from cc up 
to and including yy for record type DD are to be recorded. 


Figure 3-1. SMFPRMxx Parameters (Part 2 of 4) 


Chapter 3: Part 1 - SMFPRMxx Parameters 3-3 








EEE RE PY ERET CTTTETE  TRRETTETE TENET PITT NRTE TI YM ANN, SOWA RN ENN WMA 





SET ee en ay FT SSS ES ise Goi. a BS ee beet Paath 
7 a See Oe peer Ser ere ena ag Moos he ceed NUE cop aes eee ENE S Saeed Seeds eh Sane Ne ae Gen os Bese by ake lg ae Ol Radek ae Shae ody ahs Sk Sac tA oa. 





SYS (options) NOTYPE specifies that all records and subtypes except those: 
(continued) specified are to be written by SMF, where AA, BB, DD, and 
ZZ are the decimal notations for each record. cc and yy are 
the decimal notations for each subtype. A colon is used as a 
delimiter to indicate that all records from BB up to and 
including AA are not recorded and all subytpes from cc up to 
and including yy for record DD are not recorded. 

















Notes: 


The subtype selectivity function supports only record types 
0-127 which utilize the standard SMF header where the 
subtype field is at offset 22 (decimal) and ‘subtypes utilized’ 
bit (bit position 1) of the system indicator byte at offset 4 
(decimal) is set to x‘1’. See Chapter 6 Figure 6-2 for a sample 
‘standard header which utilizes subtypes. See each 
individual record to check if subtypes are utilized. 








Refer to Chapter 3 Part || for a description of Subtype 
Selectivity. 


including zz are not recorded. 


NOINTERVAL 
INTERVAL (hhmmss) 


NOINTERVAL specifies that no checkpoints are taken. 
NOINTERVA L is the default, | 


INTERVAL specifies the amount of real time between each 
checkpoint, where hh is the hours, mm is the minutes, and 
ss is the seconds. At each checkpoint, a type 30 record if 
specified, is written. For TSO users, a type 32 record can 
also be written. 

















000001- 
240000 


NOINTERVAL 


























The INTERVAL options allows the user to preserve 
accounting data for long-running jobs or TSO sessions. 
Because accounting data is recorded for each job or task 
each time the interval expires, the data is not completely 
lost in the event of a system failure. However, using the 
interval option causes some system Overhead. For this 
reason, caution should be used when specifying this value. 
Note that the INTERVAL value must be greater than the 

| JWT value. If the interval is less than the SWT time, 

the IEFUTL exit is not taken. 





EXITS (exit name, exit name, ... ) See explanation 


NOEXITS 


EXITS specifies which SMF exits are to be invoked. A 
maximum of 15 exits are allowed; if an exit is not specified 
then it is not invoked. If this system parameter is not 
specified, all SMF system exits are allowed. 


















NOEXITS specifies that SMF exits are not invoked. 


NODETAIL 
DETAIL 


Specifies the level of data collection. When DETAIL is 
specified for TSO, type 32 records contain the total CPU 
time under TCBs and SRBs and the total number of 
TGETs, TPUTs, EXCPs, and transactions associated with 
the command. When DETAIL is specified for STC, type 
30 records (subtypes 4 and 5) contain all the EXCP sections 
for the step or job. 





NODETAIL 





Figure 3-1, SMFPRMxx Parameters (Part 3 of 4) 
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Meaning and Use Value Range Default Value 


SUBPARM (name 
(parameters)) 


SUBSYS (name.options) 





Specifies the information to be passed to a specific N/A 

subsystem where: 

name specifies a one to four character 
subsystem name. The first character 
must be an alphabetic or national 
(#, @, or $), and the remaining characters 
can be either alphameric or national. 

parameters specifies a 1 to 60 character information 
string to be passed to the subsystem 
specified in name. SMF does not check 
the validity of the information string. 
The inner set or parentheses marks the 
beginning and the end of the information 
string. 


Specifies what data is to be collected and recorded for 

a specific subsystem, where name specifies a one to 

four character subsystem name. The first character must 

be alphabetic or national (# @, or $), and the remaining 
characters can be either alphameric or national. Through 
this publication, the term subsystem means the one to 

four character name specified in the SUBSYS parameter 

in the SMFPRMxx parmlib member. The options are 

the same as the options that can be specified with the 

SYS keyword including subtype specification. If a sub- 
system option is not specified, the corresponding SYS 
option is used. The name is not validity checked. Data can 
be recorded for up to eight subsystems in any IPL, including 
both those specified at IPL and through subsequent SET 
commands. When the limit is reached, no additional sub- 
systems can be added. The two SMF-defined subsystems 
are STC and TSO. Work started from the operator console 
is associated with the STC subsystems. Logged on TSO users 
are assigned to the TSO subsystem. Batch jobs are assigned 
to the job entry subsystem that presented the work to the 
system. The name of the job entry subsystem (for example, 
JES2 or JES3) is specified in the SCHEDULR sysgen macro 
instruction. 


Figure 3-1. SMFPRMxx Parameters (Part 4 of 4) 
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The following section describes some of the functions that can be controlled by the 
SMFPRMxx parameters. | 


Collecting SMF Statistics 


Type 23 records collect SMF statistics. Creation of the type 23 record allows the 
installation to track SMF recording activity. The type 23 record is written at the 
expiration of the interval specified in the STATUS parameter. 


The MAXDORM parameter allows the installation to minimize the amount of 
data lost because of system failure. By specifying MAXDOR\M, the installation 
specifies the period of real time that data is permitted to remain in the SMF buffer 
before it is written. 


Subtype Selectivity 


Subtype selectivity for SMF records is an option of the TYPE/NOTYPE option 
on the SYS and SUBSYS parameters used for SMF recording. Subtype selectivity 
allows more flexibility in post-processing records and helps control the amount 
of data stored in SMF datasets. 


The subtype selectivity function supports only those records which utilize the yer ~*~. 
standard SMF record header where the subtype field is at offset 22 (decimal) and q 2 
the ‘subtypes utilized’ bit (bit position 1), of the system indicator byte at offset 4 
(decimal), is set to X‘1’. SMF processes the record for subtype selectivity when 
both conditions are met. This support is limited to SMF record types 0 through 
127. User records are not supported. Check individual records to see if subtypes 
are used. 


The TYPE option of the SYS and SUBSYS parameter provides inner 
parentheses to indicate the subtypes to be collected. If siibtype selection is not 
used, the default is all subtypes. 


On the SYS or SUBSYS parameter this is a sample of how the TYPE option 
should be used to record subtypes 2, 4, 5 and 6 for the type 30 record: 


SYS(TYPE(30(2,4:6))) or SUBSYS(STC,TYPE(30(2,4:6))) 


The NOTYPE option provides inner parentheses to indicate the subtypes not to 
be collected. If subtype selection is used, all subtypes except the ones specified 
are collected. On the SYS or SUBSYS parameter this is a sample of how the 
NOTYPE option should be used to record subtypes 2, 4, 5 and 6 for the type 30 
record: 


SYS(NOTYPE(30(1,3))) or SUBSYS(STC,NOTYPE(30(1,3))) 


When using the NOTYPE keyword, data is collected for all records except those 
specified. In the example above, data is collected for record types 0 through 30, 
subtypes 2, 4, 5, 6 and records 31 through 256. 
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Notes: 


e If subtype selectivity is specified for a record type for which subtypes are not 
supported, the specification of the subtype(s) is ignored and the record type is 
recorded. No warning message is issued. 


e The specification of a subtype more than once is accepted. No warning 
message is issued. 


e If an invalid range is specified (i.e. the first value of the range is greater than 
the second value) IEE948I is issued. The user must then re-enter the valid range. 


Interval Accounting 


Record type 30 provides accounting information and consolidates data that is also 
found in record types 4, 5, 20, 34, 35, and 40. However, using the type 30 record 
simplifies accounting by means of installation-written post processing routines. 
Record type 30 is written when: 


e A TSO session, started task, or batch job starts 
e A TSO session, batch step, or batch job ends 


e The recording interval expires 


A recording interval is specified through the INTERVAL option of the SYS or 
SUBSYS keywords. A recording interval makes it possible to checkpoint 
accounting data so that if a system failure occurs, not all of the accounting data is 
lost. When the recording interval expires, a type 30 record is written that contains 
the accounting information for the job. At the end of a step, a final interval record 
includes the accounting information for the time between the last interval record 
and the end of the step. In addition, SMF produces a type 30 record that contains 
the accounting data for the entire step regardless of the number of intervals that 
have expired. | 


If the internal value is changed through the SET SMF or SETSMF command, the 
new interval does not take effect until the current interval expires. If interval 
recording is not active when a job is started, there is no interval recording for that 
job. If interval recording is turned off and then back on by means of a SET 
command, interval recording starts at the new rate, at the beginning of the next 
step. 


In the following example, the installation decided to take a checkpoint of 
accounting data for started tasks (such as VT AM) at a one-hour interval. The 
SMFPRMxx options specified: 


SUBSYS(STC INTERV AL(010000)) 
The values specified cause a type 30 record to be produced each hour after the 


start of each started task step. The record contains the accounting data for the 
resources used during the previous hour. 
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TSO Command Accounting 7 Lo 


Record type 32 contains the number of TSO commands issued by a TSO user. The 
record is written when a TSO user logs off or when an SMF recording interval 
expires. | 


Type 32 records allow the installation to keep track of individual TSO 
commands entered during a TSO session, during recording interval, or in a CLIST. 
If no commands are entered during a reporting interval, no record is created. 


The installation can specify, through the DETAIL parameter in SMFPRMxx, 
that the record is also to include the total CPU time under TCBs and SRBs and the 
total number of TPUTs, EXCPs, transactions, and TGETs associated with the 
command. 


To use the type 32 record and TSO command accounting, you must have installed 
TSO Extensions for MVS/XA. 


Many TSO commands, such as EDIT, have subcommands. These subcommands 
are also counted in the type 32 record. However, these subcommands are not re- 
corded as entered at the terminal; they are recorded with a prefix that associates 
the subcommand with a command. For example, under EDIT, the INPUT sub- 
command is recorded as EDINPUT. The prefixes are described later in this section. 


All TSO commands attached directly by the terminal monitor program (TMP) 
aa — 
are counted. However, some TSO products or, possibly, user applications currently | 
do not count TSO commands and thus do not support the type 32 record. For ed 
example, the Interactive Problem Control System (IPCS) does not count TSO 
commands. However, TSO subcommands are counted. 


The TSO command interface enables a user application to avoid this problem. 
The interface requires the user application to take the following steps both before 
each TSO command (or subcommand) to be counted begins and after the command 
completes: 


e Load register 1 with the address of a parameter list containing a four-byte flag 
word. The parameter list must start on a word boundary. The high-order bit 
of this word is set as follows: 

— 1 indicates the start of a command 
— Q indicate that the command has completed. 


Following the four-byte flag word is an eight-byte command (or prefixed-sub- 
~ command) name field. The command must be left-justified and padded with 
blanks. 


e Load register 15 with X‘19’. 
e@ Issue SVC 109. 


The user of this interface must include the name of the command or prefixed- 
subcommand in module IEEMB846 before invoking the interface. 





The IBM-supplied module IEEMB846, contains a partial list of the TSO com- 
mands, prefixed subcommands, and aliases that are counted in the type 32 record. 
All other commands are counted in the ‘***OTHER’ field. 
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An installation can use the IBM-supplied IEEMB846 or create its own module 
in SYS1.LINKLIB. The SMFTSOCM member of SYS1.SAMPLIB is provided so 


that the user can 


add or delete commands for the installation. The SMFTSOCM 


member contains the source code for the IBM-supplied IEEMB846. The format of 


IEEMB846 is: 
Offset Length Content 
0 4 Number of commands in the module 
4 4 Reserved 
8 8 Command name field 
16 8 Command name field 


Each command name field is 8 characters long. Therefore, each name must be 
left-justified and padded with blanks. The commands can appear in any order. 
However, by placing the most frequently used commands near the beginning of the 
module and deleting the commands that are not used, an installation can reduce the 
average time SMF needs to find the command. For example, after the following 
CSECT is link-edited into SYS1.LINKLIB, the ALLOCATE, ALLOC, SEND and 
GETINPUT commands are recorded in record type 32. (The GETINPUT command 
is a locally-defined command). | 


IEEMB846 
DC 
DC 
DC 
DC 
DC 
DC 
END 


CSECT 

F‘4’ 

F‘O’ 
CL8‘ALLOCATE’ 
CL8‘ALLOC} PP’ 
CL8‘SENDBBbB’ 
CL8‘GETINPUT’ 


Note: Both ALLOCATE and ALLOC, its alias, are specified. If ALLOC, or any 
other alias, is not explicitly specified in IEEMB846, each use of the alias is counted 
under ‘***OTHER’ and not under the corresponding command. 


When adding subcommand names to IEEMB846, use the following prefixes: 


Command Subcommand Prefix 
ACCOUNT AC 

EDIT ED 

OUTPUT -O 

OPERATOR OP 

TEST Af 

User-defined U 


If the length of the prefix plus the subcommand name exceeds eight characters, the 
subcommand name is truncated on the right. For example, the CONTINUE sub- 
command of OUTPUT appears in IEEMB846 as OCONTINU. 
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The subcommand prefix “U” allows an installation to collect data on user-defined . 
subcommands as long as they use the TSO Command interface. An installation that — 
has more than one user-defined command processor can add a one-digit qualifier 
(0-9, A-Z) to the prefix to differentiate between user commands. 


Recording Status Changes 


Record type 90 describes changes in SMF and system status. The type 90 record 
allows the installation to track operator changes (such as the use of the SET or 
SETSMF command), and with the PROMPT option, to establish availability and 
reliability statistics for the processor. 


If PROMPT (IPLR or ALL) is specified, the system issues message IEE956A 
when an IPL occurs. This message prompts the operator to reply with the time 
when the failure occurred, the name of the operator, and the reason for the IPL. 
This information is recorded in a type 90 record. For more information on message 
IEE956A, see System Messages. 


The installation can set up standard operator replies to the prompt message and 
then use a post processing program to summarize the reliability data contained in 
the type 90 record. For example, an operator reply of FTIME=00.00.00 might 
indicate a scheduled IPL while any other reply indicates a system failure. Also, a 
standard set of IPL reasons might be provided to the operator, such as scheduled 
production, processor failure, channel failure, JES failure code xxxx, or scheduled 
test. —_— 


Started Task Accounting 


For accounting purposes, the system sees the master address space, system address 
spaces, mounts, job entry subsystems, and tasks initiated with a START command 
at the operator console as started tasks. The system does accounting for started 
tasks much as it does for batch jobs and TSO work. Started task accounting in- 
cludes: 


e Accumulating CPU time under started task TCBs and SRBs 
e Counting started task I/O operations 

e Invoking SMF exits on behalf of started tasks 

e Creating SMF records for started task activity 


The SYS default in SMFPRMxx requests that SMF write all possible records for 
what the system sees as started tasks. For started task accounting, SMF writes 
record types 4, 5, 6, 14, 15, 17, 18, 19, 20, 23, 25, 26, 30, 40, 57, 62, 63, 64, 67, and 
68. 


You can suppress started task accounting records by suppressing the accounting 
record types through the SUBSYS option in SMFPRMxx (STC parameter). To sup- 
press all SMF records for started task accounting in a JES2 system, specify: 


SUBSYS(STC,NOT YPE(4,5,14,15,17,18,19,20,23,30,40,62,63,67,68)) 
To suppress all SMF records for started task accounting in a JES3 system, specify: 
SUBSYS(STC,NOTYPE(4,5,6,14,15,17,18,19,20,23,25 ,26,30,40,57,62,63,67,68)) 
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In either case, specifying any other record types might cause loss of data other 
than accounting data for started tasks. For example, a JES2 installation might run 
the Resource Measurement Facility, which the system sees as a started task, to 
monitor system activity. To suppress started task accounting records for the 
Resource Measurement Facility, the installation might inadvertently specify: 


SUBSYS(STC,NOT YPE(4,5 ,14,15,17,18,19,20,30,40,62,63,67,68,70)) 


Because this specification includes record type 70, the installation is suppressing, 
in addition to started task accounting data on the Resource Measurement Facility, im- 
portant data collected by the Resource Measurement Facility itself on CPU activity. 


For an initiator, the only data that is meaningful in a type 4, 5, or 30 record 
is job or session name, program name, step name, and reader start time and date. 
IEFIIC in the program name field identifies an initiator record. 


Because CPU time is accumulated for started tasks, wait time limits and job step 
time limit abends can occur. To avoid these abends, you can code TIME=1440 
on the EXEC statement in the cataloged procedure or set on the system task bit 
in the program properties table (PPT). (For more information on the program 
properties table, see System Modifications). 


Notes: 


1. MSTRJCL has been modified to include TIME=1440. 
2. Many IBM-supplied entries in the PPT have the system task bit set on. 


Passing Data To a Subsystem 


SMF allows an installation to pass up to 60 characters of information (such as 
accounting information) to a user-defined subsystem; a user-defined subsystem is 
any subsystem other than TSO, STC, JES2, or JES3. You specify the information 
to be passed in the SUBPARM parameter of the SMFPRMxx parmlib member, and 
it can be changed by an IPL or by the SET or SETSMF operator command. 


To use the information, the subsystem issues the SMFSUBP macro during its 
initialization to determine if any SUBPARM information is present or if the values 
have been changed by a subsequent IPL. (See “Using the SMFSUBP Macro to 
Determine Subsystem Parameters” later in this book.) 


In response to a SET command, SMF issues a subsystem interface (SSI) call 
to all user-defined subsystems that have a SUBPARM option specified. (For 
more information on the subsystem interface, see Diagnostic Techniques.) In 
response to a SETSMF command, SMF issues a SSI call only to the subsystem 
specified in the SETSMF command. 


To determine if any values that affect its operation have been changed, each 
subsystem, upon receiving the SSI call, must issue the SMFSUBP macro instruc- 
tion. If the subsystem determines that the information string passed to it is incor- 
rect, it uses the SMFCHSUB macro instruction to change the information. (See 
“Using the SMFCHSUB Macro to Change Subsystem Parameters”’.) 
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Selecting SMF Records Using SMFPRMxx Parameters ae, 


SMF records are selected by specifying either the type desired or the types not 
desired with the TYPE or NOTYPE option of the SYS or SUBSYS parmlib 
parameter. 


If any one of record types 14, 15, 17, 18, 62, 63, 64, 67, or 68 is specified 
with the TYPE option, data is collected for all records. Likewise, if either record 
type 19 or 69 is specified with the TYPE option, data is collected for both records. 
However, only those records that are selected as a result of TYPE or NOTYPE 


request are written to the SMF data set. 


User-written exit routines IEFU83 and IEFU84 (SMF writer) and IEFACTRT 
(termination) can also control which records are to be written to the SMF data set. 
After inspecting an SMF record, these routines return a code to the system in- 
dicating whether the record is to be written to the SMF data set. 


Entering SMFPRMxx in SYS1.PARMLIB 


When you have determined which SMF parameters to use, place them in an 
SMFPRMxx member of SYS! .PARMLIB. The two alphameric characters, 
represented by xx, are appended to SMFPRM to identify your SMFPRMxx member. 
If you do not specify an SMFPRMxx member (with system parameters, such as 
SMF=01! for member SMFPRMO1, or with an alternate member, such as 





aa 
IEASYSxx), the default member SMFPRMOO0 is used. The parameters in (| 
SMFPRMOO are: Sw 
ACTIVE /*ACTIVE SMF RECORDING*/ 
OSNAME(SYS1.MANX,SYS1.MANY) /*TWO DATA SETS MANX AND MANY */ 

PROMPT(ALL) /*PROMPT THE OPERATOR FOR OPTIONS*/ 

REC(PERM) /*TYPE 17 PERM RECORDS ONLY*/ 

MAXDORM(3000) /*WRITE AN IDLE BUFFER AFTER 30 MIN*/ 

STATUS(010000) /*WRITE SMF STATS AFTER 1 HOUR*/ 

JWT (0010) /*522 AFTER 10 MINUTES*/ 

$1D(3081) /*SYSTEM ID IS 3081*/ 

LISTDSN /*LIST DATA SET STATUS AT IPL*/ 


Severe: 255), EXITS(IEFU83,JEFU84 JEFACTRT,IEFUJV ,IEFUSI,IEFUJP, 
lEFUSO,IEFUJI,IEFUTL,IEFU29) NOINTERVAL,NODETAIL) 


/* WRITE ALL RECORDS AS THE SYSTEM DEFAULT, TAKE ALL KNOWN EXITS. 
THERE ARE NO DEFAULT INTERVAL RECORDS WRITTEN. ONLY SUMMARY 
TYPE 32 RECORDS ARE WRITTEN FOR TSO.*/ 


SUBSYS(STC,EXITS(IEFU29 JEFU83 JEFU84, |EFUJP,IEFUSO)) 


/* WRITE ALL RECORDS AS BY SYSTEM DEFAULT, TAKE ONLY FIVE EXITS, NOTE: 
{EFU29 EXECUTES IN THE MASTER ASID WHICH IS A STC ADDRESS SPACE SO 
1EFU29 MUST BE ON FOR STC. USE ALL OTHER SYS PARAMETERS AS A DEFAULT*/ 


LI AE HELE TT OL ID LE TTT LENE EERE NETIC LVEDD ELL TEE LT AE STEIN ET EDDA ILE LE LDN LLE LAE TE TN NEE NEAR SLE LH TEST NEEL TELE TIE, 





3-12 System Management Facilities (SMF) 


























The SMFPRMxx parameters can be entered in any order; however, note the 
following coding restrictions: 


e@ Code each series of parameters in logical records no more than 80 bytes long. 
@ Use columns 1-71; columns 72-80 are ignored. | 

e Enter each parameter in the format: keyword(value). 

@ 


Avoid embedded blanks. 


Indicate continuation by placing a comma after the last entry on a record, 
followed by a blank before column 72. 


e Comments must be bracket by /* and */. 


To add the SMFPRMxx parameters as a member of SYS1.PARMLIB, use the 
IEBUPDTE utility program. Figure 3-2 illustrates sample JCL for using IEBUPDTE 
to enter SMFPRMO1 into SYS1.PARMLIB. To change the default member, 
SMFPRMOO, or the installation-defined SMFPRMxx member, replace them with a 
new version by again executing IEBUPDTE. For information on the IEBUPDTE 
program, see Utilities. 





/IENTER JOB MSGLEVEL=1 
H EXEC PGM=IEBUPDTE,PARM=NEW 
/ISYSPRINT DD SYSOUT=A 


HSYSUT2 DD DSNAME=SYS1.PARMLIB,DISP=(OLD,KEEP)+ 


LISYSIN DD DATA 


/ ADD _ LIST=ALL,NAME=SMFPRMO1,LEVEL=01 SOURCE=0 
(SMFPRMO1 member) 

Jf ENDUP 

/* 


119 access SMFPRMOO on the distribution package before SYSGEN, use the 
SYS1.APARMLIB data set. 


Figure 3-2. Sample JCL for Entering SMFPRMO1 into SYS1.PARMLIB Using IEBUPDTE 


If PROMPT(LIST or ALL) was specified, the operator can modify the values in 
SMFPRMxx parameter from the console during system initialization or SET SMF 
processing. If parameter errors occur, the operator will be prompted for correct 
parameters regardless of the value specified for PROMPT. 


Using the SET Command 


The SET operator command can be used to restart SMF or modify the SMF recording 
options dynamically by specifying which SMFPRMxx parmlib member is to be used. 
The format of the command is: 


1 7 
qT (SMF=xx 


where xx is the two-character identifier of the member of SYS1.PARMLIB that 
contains the SMF options. 


If SMF terminates, you may use the SET command to restart SMF; it is not 


necessary to IPL again. For more information on using the SET command to restart. 
SME, see System Commands. 
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The SET command also allows the installation to replace the existing SMF options. fo™ 
For example, an installation can activate SMF recording after an IPL in which \ 
NOACTIVE is specified by using the SET command and choosing the parmlib member 
that contains the ACTIVE option. In addition, the installation can use the SET 
command to reactivate SMF recording after an I/O error has terminated recording; 
however, the installation should define a new data set or correct the cause of the 
I/O error before reactivating SMF recording. 


Notes: 


1. To avoid installation exit communication problems, the installation should 
terminate all address spaces except the master scheduler address space, the system 
address spaces (such as PCAUTH, ALLOCAS, and GRS) and the job entry 
subsystem before issuing a SET command that changes the EXIT keyword. 


2. The SET command cannot be used to change the SID parameter; if a value is 
specified, it is ignored. 


3. The new values for STATUS or MAXDORM do not take effect until the old 
ones, if any, expire. 


4. SET SMF, SETSMF, and DISPLAY SMF commands cannot run simultaneously. 
One waits for the other to complete before starting. 


5. A maximum of eight subsystems are allowed for each IPL. This is a combined 
total of those specified at IPL and subsequent SET commands. If the maximum 
is reached, no new subsystems may be added. Those subsystems previously 
specified can be given different options. 


6. Recording data set switching does not take place at SET time unless it is neces- 
sary. For example, if the current active data set is not included in the new ( 
options, the first empty-data set in the new data set list becomes the active : 
recording data set. 


7. If recording is not active at SET SMF time, the first non-full data set is used 
as the recording data set. 


Using the SETSMF Command 


In contrast to the SET operator command with the SMF option, which allows 

-an installation to specify a different SMFPRMxx parmlib member, the SETSMF 
operator command allows an installation to add a SUBPARM parameter or to 
replace any previously-specified parameter in the active SMF parmlib member 
except the ACTIVE, PROMPT, SID, or EXITS parameters. The SETSMF com- 
mand cannot be used with a parmlib member that specified NOPROMPT. The 
format is: 





ea 
ss 


The parameters are: 


\ parameter (value), ... 


_ parameter a 
specifies any SMF parmlib parameter except ACTIVE, PROMPT, SID, or EXITS. 


value 
specifies the new value for the specified parameter. 
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i Notes: 
( | 1. More than one parameter can be changed as long as the length of the command 
does not exceed 124 characters. 
2. Both the SUBSYS and SUBPARM specifications can be changed on the same 
SETSMF command as long as the subsystem name is the same. 
3. SET SMF, SETSMF, and DISPLAY SMF commands cannot run simultaneously. 
One waits for the other to complete before starting. 


4. The new values for STATUS or MAXDORM do not take effect until the old 
ones, if any, expire. 


Using the DISPLAY Command 


The DISPLAY (D) operator command can be used to display the status of the 
SMF data sets or the current SMFPRMxx options, to the operator console. The 
format is: 


sparen) sur|{$}] heen 


The parameters are explained below: 


o 
specifies that the status of the SMF data sets is to be displayed. 
0 
= specifies that the current SMFPRMxx options are to be displayed. 
( ; ,L=cca 
| specifies the console(cc) and the display area(a) where the action specified 
by S or O is to take place. 


Note: SET SMF, SETSMF, and DISPLAY SMF commands cannot run simul- 
taneously. One waits for the other to complete before starting. 
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( Chapter 4: User-Written Exit Routines and Facilities 


SMF has exits in the control program that can link to user-written routines for 
monitoring jobs or job steps at various points in their processing cycles. These exits 
can execute in either 24-bit addressing mode or 31-bit addressing mode. For more 
information on 31-bit addressing, see SPL: 31-Bit Addressing. An installation can 
use any or all of the SMF exits by including user-written exit routines in the 
appropriate distribution libraries before SYSGEN or in SYS1.LPALIB after SYSGEN. 
SMF automatically provides dummy routines for all unused exits. (For detailed 
information on adding user-written exit routines, see “Including Exit Routines in the 
Operating System” in the chapter “System Requirements and Considerations’’.) 


Chapter 4 is divided into three parts: 





e Part I describes user-written exit routines. 
e Part II describes testing exit routines. 


e Part III describes exit routine facilities. 


( ~ Part I — User-Written Exit Routines 


Part I introduces the SMF exits. It briefly describes when each exit is called, the 
parameters passed to it, and the return codes required from it. 


Exit Routines and Their Characteristics 


SMF supplies exits, which can link to user-written exit routines, as follows: 


@ The job validation exit (IEFUJV) receives control from the converter before 
each job control statement (or cataloged procedure) in the input stream is 
interpreted. This exit also receives control after all the JCL is converted and 
again after all the JCL is interpreted. It is not taken for JCL comment state- 
ments. A return code from this exit indicates whether processing of the job 
is to be continued. 


@ The job initiation exit (IEFUJI) receives control from the initiator before a job 
on the input queue is selected for initiation. A return code from this exit 
indicates whether the job is to be started or canceled. 


@ The step initiation exit (IEFUSI) receives control from the initiator before each 
job step is started (prior to allocation). A return code from this exit indicates 
whether the job step is to be started or the job is to be canceled. 
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e The time limit exit IEFUTL) receives control from the timer interruption 
handler when one of the following time limits expires: the job CPU time limit 
(from the JOB statement); the step CPU time limit (from the EXEC statement 
or the default from the job entry subsystem); or the continuous wait time limit for 
the job (from the SMFPRMxx JWT parameter). A return code from this exit 
indicates whether the job step is to be terminated or processing is to be 
continued with a new time limit. 


e The SYSOUT limit exit (IEFUSO) receives control from the job entry subsystem 
when the number of records written to an output data set exceeds the output limit 
for that data set. A return code from this exit indicates whether the job is to be 

terminated or processing is to be continued using a new limit. 


@ The SMF record exit (IEFU83) receives control from the SVC 83 routine before 
each record is written to the SMF data set. A return code from this exit indicates 
whether the current SMF record is to be suppressed. 


@ The termination exit TEFACTRT) receives control from the terminator on the 
normal or abnormal termination of each job step and job. A return code from 
this exit indicates whether the job is to be continued (for job steps only) or 
terminated, and whether the SMF termination records are to be written to the 
SMF data set. 


@ The job purge exit (IEFUJP) receives control from the job entry subsystem when 
a job is ready to be purged from the system (that is, after the job has terminated 
and all SYSOUT output that pertains to the job has been written). A return code 
from this exit indicates whether the SMF job purge record is to be written to the 
SMF data set. 


e The SMF dump exit (IEFU29) receives control from the SMF writer when an 
SMF data set becomes full. A return code from this exit indicates whether or 
not the dump message (IEE362]) is to be issued. 


e@ The SMF record exit (IEFU84) receives control when the SMF writer SVC is 
branch entered. A return code from this exit indicates whether the current 
SMF record is to be suppressed. 


Figure 4-1 summarizes when each SMF exit is called, the modules that call each 
user-written exit routine, the information passed to each exit (in addition to the 
common exit parameters, described in Figure 16), and the return from each exit to 
the control program. 
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( Module: Interfaces For User Parameters Passed: Type of Return: 
; With: E xit: 

IEFVHEB | Prescan in SMFEXIT | 1EFUJV (entry JCL statement image, type Continue or cancel. 
Converter : codes 0-8) of JCL statement, 

JEF VHF Converter SMFEXIT | IEFUJV (entry converterm parameter 3 
Termination code 16) 

IEF VHH interpreter SMFEXIT | IEFUJV (entry 
Termination code 32) 


{EFSMFIE | Job Initiation | SMFEXIT | IEFUJI Programmer name, job Continue or cancel. 
priority, job accounting 
fields. 


IEFSMFIE | Step Initiation | SMFEXIT | IEFUSI Job step name, program Continue or cancel. 
name, step accounting 
fields. 
{\EATLEXT | Timer SMFEXIT | JEFUTL Continue with new time limit or 
Expiration cancel. 


HASP AM! Output Limit — Continue with new limit or cancel. 
2 | Expiration 

IGCOOO8C | SVC Call to SMFEXIT | \EFU83 SMF record to be written. Write or do not write record to: 

SMF Writer SMF data set. 

SMF Buffer 

Time 


IATDMEB* | 
IEEMB830 {Branch entry SMFEXIT JIEFU84 SMF record to be written. Write or do not write record to 
call to SMF SMF data set. 
oe IEFTB721 = jJob SMFEXIT lIEFACTRT Job step name, programmer | Continue or cancel; write or do | 
( 4 Termination name, job CPU time, job not write record to SMF data set. 


accounting fields, step CPU 

IEF TB721 SMFEXIT IEFACTRT time, step accounting fields, 
completion code, SMF 
termination record. 

HASPMISC1'|Job Purge SMFEXIT IEFUJP SMF job purge record, Write or do not write record to 

[ATOSDR2 | subsystem ID. SMF data set. 

1EEMB829 |SMF Dump SMF EXIT IEFU29 SMF data set name. Tell operator to clear or 
Time not to clear SMF data set. 


' Jes2 only 
2 JES3 only 

























Step 
Termination 






Figure 4-1. Exit Routine Characteristics 
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- Sample Exit Routines in SYS1.ASAMPLIB | | —_— 








Nee gl 
ee cs 
Sample assembler language exit routines for some SMF exits are provided in the 
-member SMFEXITS of SYS1.ASAMPLIB. Figure 4-2 shows sample JCL for 
obtaining a listing of these sample routines. 
(PRINT JOB MSGLEVEL=1 
i EXEC PGM=lIEBPTPCH 
HISYSPRINT DD SYSOUT=A 
HISYSUT1 DD DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 
i UNIT=xxxx, VOLUME=SER=xxxxxx? 
IISYSUT2 DD SYSOUT=A 
LISYSIN DD x | 
PRINT TYPORG=P0 MAXNAME=1,MAXFLDS=1 
MEMBER NAME=SMFEXITS 
RECORD FIELD=(80) 
/* 
1The volume and unit parameters depend upon your installation’s request. 
Figure 4-2. Sample JCL For Obtaining a Listing of Sample Exit Routines 
A summary of the sample exit routines in SYS1.ASAMPLIB follows: 
e IEFUJV — Sample routine checks the validity of a continued JOB statement 
and of values supplied for REGION, PRTY, TIME, and accounting 
parameters in the JOB statement. The routine uses characters 
from the account number to index a table that contains allowable a 
values for these parameters. If any value is invalid, the sample ' J 
IEFUJV routine terminates the job. nee 
e IEFUJI = — Sample routine determines how long a job has been on the input 


job queue before it is initiated. It then writes this value and the 
job priority to the SMF data set as a user record. 


e IEFUSI — No sample provided. 


@ IEFUTL -— Sample routine terminates a job if either the job CPU time limit or 
the job step CPU time limit has been exceeded. If the continuous 
wait time limit for the job has been exceeded, the routine extends 
the limit twice; on the third entry for exceeding the continuous 
wait time limit, it cancels the job. The continuous wait time limit 
is not an accumulation of all the time the task spends waiting but 
rather a single continuous wait period that exceeds the specified 
limit. Each time the routine is entered for exceeding the continuous 
wait time limit, it writes a record describing the action taken to 
the SMF data set. 


@ IEFUSO — No sample provided. 
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( ‘ e IEFU83 — Sample routine determines whether the record to be written is an 
IPL record. If it is, the routine writes to the operator with a reply 
request for the record types to be written. If the record is not an 
IPL record, the return code depends upon the records currently 
requested. | 


The sample IEFU83 routine has a special macro definition for 
“write to operator with reply” so that output normally directed to 
the operator is suppressed and a standard reply is assumed for 
testing with the TESTEXIT procedure. Remove this macro 
definition if you want the message printed at the console. The 
sample routine also has special macro definitions for “write to 
operator” and “wait”, which generate no-op instructions. 


e IEFU84  — No sample provided. 


e IEFACTRT— Sample routine changes the-SMF job termination (types 5 and 35) 
and job step termination (types 4 and 34) records (unless the job 
step is flushed) to user records, and attempts to write them to the 
SMF data set. If the data set is full, the routine writes a message 
to the console indicating that SMF records are being lost. At job 
termination, the routine writes a record containing the job name, 
programmer’s name, and account number to the SYSOUT data set. 





e IEFUJP -— No sample provided. 


@ IEFU29 — No sample provided. 
( | Writing Exit Routines 


This section describes: 


e Exit routine restrictions and facilities, including information on communication 
among user-written exit routines; the common parameters passed to all routines; 
the SMF macro instructions, which are used to write records to the SMF data 
set; and the IFASMFR macro instruction, which is used to symbolically address 
fields in the SMF records. 


e Exit routines, including a full description of the parameters passed to each 
routine.and the required return codes. 


Exit Routine Restrictions 


This section describes only the restrictions and conditions common to most user- 
written exit routines. For those restrictions and conditions that involve only one 
or two exit routines, see the specific routine(s) later in this chapter. 


Before writing an exit routine, note the following user-written exit routine 
restrictions and conditions: 


e@ All user-written exit routines must be reenterable and refreshable 
because PLPA pages are stolen and can be paged-in but not paged-out. 
Any code changes would be overlaid by subsequent page-in. 
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e All user-written exit routines receive control via a BALR instruction. The 
routines must save registers when they receive control and restore registers 


when they return control to the control program. Register 13 contains the 
address of the register save area; register 14 contains the return address; and 
register 15 contains the entry point address. 


e SMF exit routines can execute unchanged in MVS/XA. If the exit routines 
are rewritten to either address data above the 16-megabyte line or to reside 
above the 16-megabyte line, and are link edited again, SMF passes control to 
the exit routines in the proper addressing and residency mode. You 
establish addressing and residency modes at system initialization or 
through EXIT parameters on the SETSMF command. Exits that run in 
31-bit addressing mode must return control to SMF via a BSM instruction. 


e Figure 4-3 shows the storage proctection key in which each user-written exit 
routine receives control. 


| Key | Exit Routine 


IEFUJV (with entry code 32) 
lEFUJI 
lEFUSI 
lEFUTL 

IEFU83 
lEFU84 
 IEFACTRT 


1EFU29 

















IEFUJV (with entry codes 0-16) 
IEFUSO 
IEFUJP 






Figure 4-3. Storage Protection Keys 


e All user-written exit routines receive control with the system enabled for 
interrupts. 


@ No user-written exit routines except IEFACTRT can write to the system output 
message data set. 


e Do not allocate installation-defined data sets to SYSOUT. 


e User exits must use standard linkage conventions. 
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e User-written exit routines entered for foreground jobs cannot access instal- 
lation-defined data sets. Routines entered for background jobs must write 
to installation data sets defined as follows: 


— A data set used by the exit routines IEFUJI, IEFUSI, IEFUTL and 
IEFACTRT requires a DD statement in the initiator cataloged procedure. 


A data set used by the IEFUJV and IEFUJP exit routines requires a DD 
statement in the job entry subsystem cataloged procedure. 


User-written exit routines IEFUSO, IEFU29, IEFU83, and IEFU84 cannot 
write to installation-defined data sets. 


IEFUJV, IEFUJI, IEFACTRT, and IEFUSI cannot access ISAM data sets. 





e All user-written exit routines that issue a WIOR macro instruction should 
also specify the LONG=YES parameter in the WAIT macro instruction. 


e If you plan to use the TESTEXIT procedure for testing user-written exit 
routines, see “TESTEXIT Exit Routine Requirements’”’ in Part II “Testing Exit 
Routines” of this chapter. 





e If you plan to use the IBM OS/VS Sort /Merge Program Product, do not 
create any records smaller than the minimum length required by the 
program. (When using tape work devices, the minimum length this program 
can sort is 18 bytes. Otherwise, the minimum is one byte.) 


‘e IEFU84 cannot issue any SVCs. 





( Common Exit Parameter Area 


When a user-written exit routine receives control, register 1 points to a list of four- 
byte addresses. The first entry in this list is common to all exit routines except 
IEFU83, IEFU84, and IEFU29. The first entry points to a parameter area that 

is 36 bytes long. 


Figure 4-4 describes the format of the common exit parameter area. Each job has 
its own common exit parameter area. Note that the fields in this parameter area are 
filled chronologically; therefore, not all fields are meaningful for all user-written exit 
routines. 
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Displacement Field Data a J 
from Pointer Size Format Description > 
0 8 EBCDIC Job name 
8 4 binary Time, in hundredths of a second, reader recognized the JOB card for this job 
12 4 packed Date reader recognized the JOB card for the job, in the form OOY YODDF 
8 | where F is the sign 
16 | | 4 EBCDIC System identification (taken from SID parameter?) 
20 8 EBCDIC User identification. SMF places this data in all subsequent records for this job. 
This field is initialized to EBCDIC blanks when each job is read 
28 1 binary Number of the step being processed 

29 1 binary Indicator of the SMF options selected by the user 
Bit Meaning When Set 
0 Reserved 
1 Reserved 
2 Reserved 
3 Data set accounting. Record types (see note 3) selected 
4 Volume accounting. Record types 19 or 69 selected 
5 Reserved 
6 Type 17 records will be written for temporary data set (REC(ALL)) 
7 if 0, background job. If 1, foreground job 


30 1 binary Restart indicator 
Bit Meaning When Set 


0 Automatic restart 
1 Automatic checkpoint/restart 
2 Step continue 
3 Reserved ere 
ie \ 
4 System restart 
5-7 Reserved \ 
31 1 EBCDIC Job class 
32 4 binary User-communication field. This field is intended for communication among user- 


written exit routines within a unique job. The field is initialized to zeros by 
the job entry subsystem when the control block is first passed to the converter. 





1 Modifications for the SID parameter are ignored during a system restart IPL for SMF record types 4, 5, 34 and 35. 
“These fields are provided for user modification. 


Sif one of record types 14, 15,1 iB 18, 62,.63, 64, 67, or 68 is selected, this bit is set on. 


Figure 4-4. Common Exit Parameter Area 
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Exit Routines 


IEFUJV — Job Validation Exit 


IEFUJV receives control before the system converts each job control statement (or 
cataloged procedure) in the input stream and again after it converts all JCL. This 
exit routine also receives control after the system interprets all JCL. The procedure 
does not receive control for comment statements for console-started tasks. A user- 
written IEFUJV exit routine could do any or all of the following: 


e Validate any account fields included in the JOB and EXEC statements (except 
symbolic parameters) by comparing them to a standard list. 


Validate or assign the REGION request. 

Validate or assign job TIME and job step TIME parameters. 

Control output stream data by using the OUTLIM or SPACE parameters. 
Check for authorization to use restricted data sets. 

Create user-written records. 


Assign the user identification to be included in both the SMF job/step 
termination record and the SMF job purge record. 


Limit the size of temporary data sets handled by VIO. 
e@ Require checkpoint/restart for jobs requesting a large amount of CPU time. 
e Enforce installation standards on usage of the ADDRSPC=REAL parameter. 


@ Override certain JES initialization parameters (such as designation of where 
SWA blocks are to be obtained) that are passed to converter routines. 


Notes: 

1. If a cataloged procedure is used, it is expanded before the IEFUJV exit routine 
receives control; the sequence of statements is JOB, EXEC PROC=. 

EXEC PGM=... , followed by the other statements of the eae es Override 
statements immediately precede the statements being overriden. Note, however, 
that the resolved values for symbolic parameters are not passed to the IEFUJV 
exit routine. 

2. When modifying a JCL statement, do not include additional JCL statements or 
continuation cards. Also, when adding or modifying operand fields, begin the 
first operand field in the same place that it was before any additions or 
modifications were made. 

3. Depending upon the processing to be performed, it may be more efficient to 
check JOB and EXEC statement accounting fields in the IEFUJI exit routine and 
the first IEFUSI exit routine, respectively. The accounting fields are passed as 


parameters to IEFUJI and IEFUSI, making a statement scan routine unnecessary. 


Either of these exit routines can assign user identification, and the IEFACTRT 
exit routine can write messages to the system output message data set. 

4. To use installation-defined data sets with this exit routine, you must define them 
with a DD statement in the job entry subsystem cataloged procedure. When 
running JES2, you must also define the data sets with a DD statement in the 
initiator cataloged procedure. 
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5. When running JES2, you can use the job statement accounting field scan exit fo™ 
(Exit 3), as well as the IEFUJV exit. Exit 3 interprets any variables in the JOB Me 
card accounting field, and sets the appropriate fields in JES2 control blocks 
representing these variables. Because the exit receives control before the IEFUJV 
exit, do not use the IEFUJV exit to change the following fields of the JOB card: 
CLASS, MSGCLASS, NOTIFY, PRTY, PASSWORD and TYPRUN. For more 
information about Exit 3, see System Programming Library: JES2 Initialization 
and Tuning. 

When running JES3, a JES3 user can use JES3 user exits, in addition to the 
IEFUJV exit, to write programs to examine and change the results of interpreter 
processing and allow the job to proceed or to flush the job from the system. For 
more information about the JES3 user exits, see System Programming Library: 
JES3 User Modifications and Macros. 

6. For jobs canceled by IEFUJV from the converter, only SMF record types 6 and 
26 are generated. 

7. Conversion might take place on one CPU and interpretation of the same job on 
another. Therefore, the IEFUJV exits could receive control on different CPUs 
for the same job, and timing comparisons of the job flow would not be valid. 

8. If an installation checks job card accounting in the IEFUJV exit for all tasks, the 
IEFUJV exit should not be taken, unless modified, for started tasks. Started 
tasks do not have any job card accounting and might be cancelled by the user 


exit.. 
Parameters = 
a > 
At entry to the IEFUJV exit routine, register 1 points to a list of four-byte addresses, ae 
as follows: 


1. The address of the common exit parameter area. (See Figure 4-4). 


2. The address of an 80-character JCL statement image (in EBCDIC). (JCL 
statements are identical to those listed’ in the SYSOUT data set; control 
statements containing only comments and resolved values for symbolic parameters, 
however, are not made available to this exit routine.) 


3. The address of a one-byte area that indicates the type of JCL statement being 
passed to this exit routine. The indicator will be a binary value, as follows: 


indicates a null statement. 
indicates a JOB statement. 
indicates an EXEC statement. 


indicates a DD statement. 

indicates a PROC statement. 

16 indicates all JCL has been converted. 

32 indicates a JDT (JCL definition table) defined verb. 

64 indicates that JDT defined JCL appears on this statement. 


cof N= © 
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4. The address of the JES initialization parameters that are passed to the converter 
routine. The address points to the first converter parameter field. The field is 
a bit map, one byte in length, defined as follows for bits that are set on: 


X‘01’ Programmer name required. 
X‘02’ Account number required. 
X‘04’ Obtain SWA blocks above the 16M line. 


Note: The account number must not be required in the exit for started task 
JOB cards because there is no way to put an account number on a started task 
JOB card. An accounting number can be required on an EXEC card in 
SYS1.PROCLIB. 


Return Codes 


IEFUJI — 


Before the IEFUJV exit routine returns to the control program, it must place a 
return code in register 15, as follows: 


0 indicates job processing should be continued. 


4 indicates job processing should be canceled. 


Job Initiation Exit 


IEFUSI receives control when the initiator selects a job on the input queue for 


initiation. A user-written [IEFUJI exit routine could validate job accounting 
information or write to a user data set. It could also determine how long a job 

was on the input job queue before the initiator selected it. If the System Availability 
Management (SAM) Function is active and operational, SMF calls the SAM job/step 
initialization exit routine, AMSUJI, before it calls IEFUJI. IEFSMFIE then uses 
SMFEXIT to call the SMF job start user exit, IEFUJI. 


Notes: 

1. If an installation uses major and minor account numbers with several fields, this 
exit routine is easier to use than IEFUJV for account number processing because 
the accounting fields are placed in a formatted list. Figure 4-5 shows the format 
of the JOB statement accounting information that is available to IEFUJI. 


Offsets 
Dec. Hex. Length Format Description 
0 0 1 binary Number of accounting fields. 
1 1 variable EBCDIC Accounting fields. Each entry for an accounting 


field contains the length of the field (one byte, 
binary) followed by the field (EBCDIC). A zero 
indicates an omitted field. 


Figure 4-5. Format of Accounting Information Passed to JEFUJI and IEFUSI 


2. At job step or job termination, use the termination indicators in record types 4, 
5, 30, 34 and 35 to determine whether IEFUJI canceled the job. 


3. To use installation-defined data sets with this exit routine, you must define them 
with a DD statement in the initiator cataloged procedure. 
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Parameters fo 
, YW 
At entry to the IEFUJI exit routine, register 1 points to a list of four-byte addresses 
as follows: 
1. The address of the common exit parameter area. (See Figure 4-4.) 
2. The address of a 20-byte area containing the programmer’s name (in EBCDIC) 
from the JOB statement. This area is aligned left and padded with blanks if 
necessary. | 
3. The address of a one-byte area indicating (in binary) the requested job 
selection priority. This field equals the user-assigned priority of 0 to 14 
(taken from the PRTY parameter on the JOB statement). 
4. The address of an area containing the accounting information from the JOB 
statement. (See Figure 4-5.) 
Return Codes 
Before the IEFUJI exit routine returns control to the control program, it must place 
a return code in register 15, as follows: 
0. indicates job processing should be continued. 
4 indicates job processing should be canceled. 
IEFUSI — Step Initiation Exit 
IEFUSI receives control before the initiator starts each job step. A user-written \ : 


TEFUSI exit routine could: 
e Validate job step accounting information 
e@ Write to a user data set 


e For long-running jobs, create a user step-initiation record in the case of 
system failure 


@ Set region size and GETMAIN limit defaults for all applications. For more 
information on using IEFUSI to limit the region size, see System Modifications. 


Notes: 

1. If an installation uses major and minor account numbers with several fields, this 
exit routine is easier to use than IEFUJV for account number processing because 
the accounting fields are placed in a formatted list. Figure 4-5 shows the format 
of the EXEC statement accounting information that is available to IEFUSI. 


2. At job or job step termination, use the termination indicators in record types 4, 
5, 30, 34 and 35 to determine whether IEFUSI canceled the job. 


3. To use installation-defined data sets with this exit routine, you must define them 
with a DD statement in the initiator cataloged procedure. 


4. If region requested by a job is greater than 16 megabytes, 32 megabytes will be the 
minimum region established.by VSM. IEFUSI can override (increase or decrease) the 
32 Mb value set by VSM for extended limit and extended region size. 
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Parameters 











At entry to the IEFUSI exit routine, register 1 points to a list of four-byte addresses, 
as follows: 


1. The address of the common exit parameter area. (See Figure 4-4). 


2. The address of an eight-byte area containing the job step name (in EBCDIC) 
from the EXEC statement. This area is aligned left and padded with blanks if 
necessary. 


3. The address of an eight-byte area containing the program name (in EBCDIC) 
from the EXEC statement. This area is aligned left and padded with blanks if 
necessary. If you use a refer back, the area contains “pgm=*.DD”’. 


4. The address of an area containing the accounting information from the EXEC 
statement. (See Figure 4-5.) 


5. The address of a six-word area containing region limit values. (See Figure 4-6.) 


6. The address of a word containing a flag indicating a V=R job. (See Figure 4-6.) 


Return Codes 


Before the IEFUSI exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 


0 indicates job processing should be continued. 


4 indicates job processing should be canceled. 


‘~* 
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Register 1 


in 
‘ Common SMF exit parameter area Flag word (initialized to 0) 
' Job step name (from EXEC ' Region size requested 
statement) 8 


GETMAIN limit value below 16 
megabytes“ 


——> 










f Program name (from EXEC 
statement) 12 
Region size below 16 megabytes 


GETMAIN limit value above 16 
megabytes 


16 
SRM information fullword 20 2 
Ore Region size above 16 megabytes 


2 
Step accounting information 


| 


4 VSM parameter list 


: 





Reserved® 
: The VSM flag word contains: 
Bit Meaning 
0 on= lEFUSI has set region limit values. 


NOTE: If GETMAIN limits are not set by the exit, but a check for 
contiguous free space by VSM should be performed, Bit 0 of the VSM 
flag word must be set. ae 
1 on= _ VSM is not to check for the availability of the requested amount ( 
of contiguous free space below 16 megabytes. Mics 
off = VSM is to check for the availability of the requested amount of 
contiguous free space below 16 megabytes. 
NOTE: VSM tests this bit only when the REGION value is less than 
16 megabytes. 
2 on= VSM is to check for the availability of the requested amount of 
contiguous free space above 16 megabytes. 
off = VSM is not to check for the availability of the requested amount | 
of contiguous free space above 16 megabytes. | 
NOTE: VSM tests this bit only when the REGION value is greater than 
16 megabytes. 
3-31 Reserved 


NOTE: Because of compatability considerations for previous MVS/XA 
releases, the settings for bits 1 and 2 have opposite meanings. In pre- 
vious releases, VSM made no checks for free space above sixteen mega- 
bytes. Now, if the amount of contiguous free space requested is critical | 
for the step to be executed, bit 2 must be turned on. 


: On every entry to IEFUSI, the last four words in the VSM parameter list are set to 
X‘FFFFFFFF’. 


Ww 


The SRM flag word is received 


Figure 4-6. IEFUSI Input Parameter Structure 
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IEFUTL — Time Limit Exit 





IEFUTL receives control from the timer second level interrupt handler when one of 
the following time limits expires: 


e@ The job CPU time limit (from the JOB statement). 


e The step CPU time limit (from the EXEC statement or the default from the job 
entry subsystem). 


e The continuous wait time limit for the job (from the SMFPRMxx JWT parameter). 


A user-written IEFUTL exit routine could do any of the following: 

Cancel a job. 

Inform the operator that a job has exceeded its continuous-wait-time limit. 
Extend CPU time limits for selected jobs. 

Extend wait time limit within a job. 


Keep a record of time limit expirations. 


Vary the handling of time limit expirations for different types of jobs, such as 
teleprocessing, test, or production jobs. 


e In addition to interval accounting and the expiration of MAXDORM, the exit 
can collect information at fixed intervals for long-running jobs to prevent loss of 
data in case of system failure. (See Note 1 for more information on testing a 
resource’s availability before issuing an SMFWTM or SVC.) 


( Notes: 


1. A system interlock occurs anytime IEFUTL enqueues on a resource already 
enqueued on by the job step task or any of its subtasks. (More specifically, the 
initiator abnormally terminates if IEFUTL enqueues on such a resource because 
the asynchronous exit interface routine sets a “step must complete”’ status 
before IEFUTL receives control.) The enqueue can be explicit (for example, 
issue ENQSVC in exit IEFUTL) or implicit (the enqueue is done by an SVC 
that was issued by IEFUTL). An interlock also occurs if IEFUTL issues a TGET 
or a TPUT when the session manager is active during a TSO session. 


In any case, you can try to minimize the possibility of an interlock by first 
determining the resources used before the SVC or TSO macros were issued. Issue 
an ENQ macro specifying (1) the major and minor resource names in the 
QNAME and RNAME parameters, and (2) the RET=TEST parameter, as follows: 


ENQ(QNAME,RNAME,E,3(SYSTEM),RET=TEST,MF=(E,CNTLADDR) 


Because SMF exits must be reentrant, be sure to use the execute form of the 
macro. 


For more information on the ENQ macro instruction, see System Macros and 
Facilities. 
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2. A -user-written IEFUTL exit routine should control the number of extensions 
for a given step to prevent looping. It can record the expiration in the SMF 
data set or write a message to the console, however, in doing so, a system 
interlock could occur. (See Note 1.) To record the expiration in installation- 
defined data sets, you must define the data sets with a DD statement in the 
initiator cataloged procedure. 


3. CPU time is collected in two categories: execution under TCBs and execution 
under SRBs. The limiting function and the IEFUTL exit interfaces apply 
only to TCB time. 


4. Ifajob time limit is not specified on the JOB statement, the time limit for each 
job step is the value specified for the TIME= parameter on the EXEC statement, 
or the default value from the job entry subsystem. 


If a job time limit is specified on the JOB statement, the time limit for each job 
step is the remaining job time or the job step time limit (from the TIME= 
parameter or the job entry subsystem default), whichever is smaller. 


5. You can extend execution and wait time only within a step. Each extension resets 
the limit for the entire step to the extension value. If the step does not use all of 


the extended execution time, the time is not carried over for the next step. 


6. The wait time limit extension value replaces the previous wait time limit for 
the step. 


7. The smallest time extension granted is 220 microseconds or 1.048576 seconds. 


8. The CPU time-used field is checked each time a task status is saved, to determine 
if the specified time limit has been exceeded. 


Parameters 


At entry to the IEFUTL exit routine, register 1 points to the four-byte address of 
the common exit parameter area. (See Figure 4-4.) Register 0 will have a binary 


value, as follows: 


Q indicates the job CPU time limit expired. 
4 indicates the step CPU time limit expired. 


8 indicates the continuous wait time limit for the job expired. 


Return Codes 


Before the IEFUTL exit routines returns control to the control program, it must 
place a return code in register 15, as follows: 


Q indicates job processing is to be canceled. 
4 indicates job processing is to be continued with a time extension in timer units. 


8 indicates job processing is to be continued with a time extension in seconds. 


You must place the time extension in register 1; you can determine the number 
of timer units by the algorithm: 


1 second = 38400 timer units. 
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IEFUSO — SYSOUT Limit Exit 


Parameters 


IEFUSO receives control from the job entry subsystem when the number of records 
written to an output data set exceeds the output limit for that data set. If the output 
limit is exceeded and an IEFUSO exit routine is not supplied, the job entry subsystem 
cancels the job. To specify the output limit, use the OUTLIM parameter on the DD 
statement defining the output data set. Note that the OUTLIM parameter limits output 
only to spooled data sets. This parameter is described in JCL. 


A user-written IEFUSO exit routine could: 
@ Cancel a job that exceeds its output limit. 


@ Inform the operator when a job exceeds its output limit and let the job continue 
processing. 


e Extend output limits for selected jobs. 


@ Keep a record of jobs that exceed output limits. 


Notes: 


1. If IEFUSO indicates that the output limit is to be increased (register 15=4) but 
you do not increase the limit (register 1=0), the exit routine will receive 
control again when the next record is written to the output data set. 


2. The IEFUSO exit routine cannot access installation-defined data sets. 


At entry to the IEFUSO exit routine, register | points to the four-byte address of 
the common exit parameter area. (See Figure 4-4.) 


Return Codes 


Before the IEFUSO exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 


4 indicates job step processing is to be continued and the output limit is to be 
increased by the value placed in register 1. 
A value other than 4 indicates job step processing is to be canceled. 


TEFU83 — SMF Record Exit 


IEFU83 receives control before the SVC 83 routine buffers each record. This exit 
routine does not receive control for records whose writing has been suppressed either 
because of a system failure or because of options selected at IPL time. A user-written 
JEFU83 exit routine could: 


Select or suppress those records to be written to the SMF data set. For example, 
an installation with a large TSO account might want to suppress the SMF dynamic 
DD records (type 40). 


Check resource usage during a specific interval. For example, select records during 
the peak workload period. 


Chapter 4: Part I — User-Written Routines 4-17 
































Notes: 

1. The IEFU83 exit routine cannot access installation-defined data sets. Also, it 
cannot issue the SMFWTM or SMFEWTM macro instruction to write to the 
SMF data set. 


2. The addresses of the user-communication and user-identification fields of the 
common exit parameterarea are not passed to the IEFU83 exit routine. (To 
obtain these addresses, the exit routine could follow the pointers to the 
TCTJIMR field via the TCB plus X‘A4’.) 


3. If IEFU83 abnormally terminates, SMF, in most cases, does not terminate. 
SMF marks the exit as invalid and issues message [EE952I to the operator. If 
the exit performs a critical function, the operator can issue a SET SMF or 
SETSMF command to terminate recording. Otherwise, recording continues, 
but SMF does not invoke the exit. 


Parameters 


At entry to the IEFU83 exit routine, register 1 points to the four-byte address of 
the record descriptor word (RDW) of the SMF record to be written. 


Return Codes 


Before the IEFU83 exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 
Q indicates the record is to be written to the SMF data set. 


4 indicates the record is not to be written to the SMF data set. 


IEFU84 — SMF Record Exit 


IEFU84 receives control before the branch entered SMF writer (SMFEWTM 
BRANCH=YES) routine buffers each record. The routine may be running 
locked or in SRB mode. This exit routine does not receive control for records 
whose writing has been suppressed because of options selected at IPL time. A 
user-written IEFU84 exit routine could: 


e@ Select or suppress those records to be written to the SMF data set. For example, 
an installation with a large TSO account might want to suppress SMF records for 
all but a few selected TSO users. 


e Check resource usage during a specific interval. For example, select records 
during the peak workload period. 


e@ Suppress some of the record type 30 subtypes. 
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Notes: 
1. The IEFU84 exit routine cannot access installation-defined data sets. Also, it 


cannot use the SMFWTM or SMFEWTM macro instruction to write to the SMF 
data set. 


2. Since IEFU84 may be locked or in SRB mode, the exit routine cannot issue any 


SVCs. IEFU83 may be given the alias name IEFU84, if IEFU83 can run locked 
or SRB mode. | 


3. The addresses of the user-communication and user-identification fields of the 
common exit parameter area are not passed to the IEFU84 exit routine. (To 
obtain these addresses, the exit routine could follow the pointers to the 
TCTJMR field via the TCB plus X‘A4’.) 


4. If IEFU84 abnormally terminates, SMF, in most cases, does not terminate. 
SMF marks the exit as invalid and issues message IEE952I to the operator. If 
the exit performs a critical function, the operator can issue a SET SMF or 
SETSMF command to terminate recording. Otherwise, recording continues, but 
SMF does not invoke the exit. 


5. IEFU84 is called from the SMF address space rather than the master scheduler 
address space at system initialization (IPL) for record types 0, 8, 19, 22, and 90. 
Therefore, if IEFU84 references data in the master scheduler private area, 
which is no longer available, for record types 0, 8, 19, 22, and 90, you must 


modify the exit. Use cross memory instructions (SSAR, MVCP, and MVCS) to 
move data between the two address spaces. 
Parameters 


At entry to the IEFU84 exit routine, register 1 points to the four-byte address of 
the record descriptor word (RDW) of the SMF record to be written. 


Retum Codes 


Before the IEFU84 exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 
O indicates the record is to be written to the SMF data set. 


4 indicates the record is not to be written to the SMF data set. 
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IEFACTRT — Termination Exit. 





IEFACTRT receives control from the terminator when each job or job step 
normally or abnormally terminates. If the System Availability Management (SAM) 
Function is active and operational, SMF calls the SAM job/step termination exit 
routine, AMSACT, before it calls IEFACTRT. A user-written IEFACTRT exit 
routine could perform various functions that are unique to an installation’s 
requirements. For example, the routine could: 


e Write selected job/step records to an installation-defined data set for further 
analysis. : 


@ Include additional information in the SMF job/step termination records. 


e Write messages to SYSOUT to provide additional information about the job/step. 
For example, if the operator canceled the job, issue a WTOR to learn why the 
job was canceled, and then write the reason as a message to SYSOUT. 


@ Write an estimated job/step cost to SYSOUT. 


e@ Update tables that describe the amount of resources allowed to certain users. 
For example, keep a total of the CPU time used by specific users and flag their 
account numbers if they exceed their allowed time limit. 


Notes: 

1. IEFACTRT is the only exit routine than can write to the system output message 
data set, and only by passing a message to module IEFYS. If a user-written 
IEFACTRT exit routine writes messages for system output, the contents of 
register 12 must be the same as when the routine received control, and register 13 Bice 
must contain the address of an 18-word work area. Figure 4-7 shows the procedure 
to use when writing system output messages from IEFACTRT. Note that the a 
maximum number of characters printed on one line is 132. 





MVC 36(4,12), MSGADDR MOVE MESSAGE ADDRESS AND 


MVC 42(2,12),MSGLEN LENGTH TO SYSTEM TABLE 
L REG15,VIEFYS BRANCH AND LINK TO MESSAGE 
BALR REG14,REG15 ROUTINE 

MSGADDR DC A(MSG) 

MSG DC C’message text’ 

MSGLEN DC H’xx’ MESSAGE LENGTH? 

VIEFYS DC V(IEFYS) 





1The message will be truncated to 132 characters if necessary. 


Figure 4-7. Writing System Output Messages from IEFACTRT 


2. IEFACTRT can direct output to the console or to the system output device. It 
can also write to the SMF data set or to an installation-defined data set. To use 
installation-defined data sets with this exit routine, you must define them with 
a DD statement in the initiator cataloged procedure. 


3. At job step or job termination, use the termination indicators in record types 4, 
5, and 30, to determine whether IEFACTRT canceled the job. 


4. If the type 30 record exceeds 32,756 bytes and is split additional type 30 
records are produced, and IEFACTRT is also entered for each of these records. 
See ‘Notes’ under the description of record 30 for more information concerning 
maximum length. 
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Parameters 





At entry to the IEFACTRT exit routine, register 1 points to a list of four-byte 
addresses, as follows: 


1. The address of the common exit parameter area. (See Figure 4-4.) 


10. 


Return Codes 


. The address of an eight-byte area containing the job step name (in EBCDIC). 


This area is aligned left and padded with blanks if necessary. At job termination, 
the address is zero. 


. The address of a 20-byte area containing the programmer’s name (in EBCDIC). 


This area is aligned left and padded with blanks if necessary. 


. The address of a four-byte area whose first three bytes contain the job CPU time 


under TCBs, in hundredths of a second (in binary), and whose last byte contains 
the number of accounting fields in the JOB statement (in binary). 


. The address of an area that contains accounting information from the JOB 


statement. This area has the format described earlier in Figure 4-5, excluding the 
first field shown (the number of accounting fields). 


. The address of a four-byte area whose first three bytes contain the step CPU time 


under TCBs, in hundredths of a second (in binary), and whose last byte contains — 
the number of accounting fields in the EXEC statement (in binary). At job 
termination, the address is zero. 


. The address of an area that contains accounting information from the EXEC 


statement. This area has the format described earlier in Figure 4-5, excluding the 
first field shown (the number of accounting fields). At job termination, the 
address is zero. 


. The address of a two-byte area. The first byte is an indicator: if bit 7 is set to 1 


when the exit routine is entered, the job has been canceled; if the exit routine 
sets bit 7 to 1, the job will be canceled. The second byte contains the number of 
the job step currently being processed. At job termination, the second byte 
contains the number of steps in the job. 


. The address of a two-byte area containing the termination status (condition or 


completion code) of the job or job step. 


The address of an area containing a four-byte record descriptor word (RDW) 
immediately followed by the job step termination record (type 4 or 34) or the 
job termination record (type 5 or 35) or the common address space work 
record (type 30), or the TSO command counting record (type 32) to be | 
written to the SMF data set. 


At entry to the IEFACTRT exit routine, register 0 contains a binary code 


indicating the reason for entry, as follows: 


12 indicates job step termination. 


16 indicates job termination. 


20 indicates job or step termination. The tenth parameter is the address of the 


RDW for a type 30 record. The subtype field in the record determines if it 
is a job or step termination record. 


24 ~—indicates that the tenth parameter is the address of the RDW for a type 32 





record. 
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Return Codes 





Before the IEFACTRT exit routine returns control to the control program, it must 
place return codes in registers 1 and 15, as follows: | 


e@ In register 1: 


4 : indicates the termination record is not to be written to the 
SMF data set. 

A value other than 4 indicates the termination record is to be written to the 
SMF data set. 


e In register 15: 
4 indicates the remaining job steps are to be canceled. 


A value other than 4 indicates job processing is to be continued. 


IEFUJP — Job Purge Exit 


IEFUJP receives control when a job entry subsystem is ready to purge a job from 
the system, that is, after a job has terminated and the system has written all the 
SYSOUT output that pertains to the job. A user-written IEFUJP exit routine 
could use the SMF job purge record (type 26) to summarize a job’s activities in 
the system. 


Note: To use installation-defined data sets with this exit routine, you must define 
them with a DD statement in the job entry subsystem cataloged procedure. 


Parameters 


At entry to the IEFUJP exit routine, register 1 points to a list of four-byte addresses, 
_as follows: 


1. The address of the common exit parameter area. (See Figure 4-4.) 


2. The address of an area containing the job purge record (type 26) to be written to 
the SMF data set. 


Return Codes 


Before the IEFUJP exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 


4 indicates the job purge record is not to be written to the 
SMF data set. 


A value other than 4 indicates the job purge record is to be written to the SMF 
data set. 
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| ( JEFU29 — SMF Dump Exit 


TEEMB829 calls IEFU29 whenever a SMF data set requires dumping. Some 
examples are: 


e During SMF initialization for alternate data sets that are not empty. 
e During SWITCH SMF command processing for a data set that is not yet full. 
e During SMF processing when a data set becomes full. 


A user-written IEFU29 exit routine can issue a WTO macro instruction re- 
questing the operator to start the dump program or can initiate the dump program 
by submitting a job request to an internal reader. For more information on sub- 
mitting a job request to an internal reader, see System Modifications. 


Note: IEFU29 runs in the SMF address space. If an existing exit routine 
references data that exists in the private area of the master scheduler address 
space, you must modify the exit. Use cross memory instructions (SSAR, 
MVCP, and MVCS) to move data between the two address spaces. 


Parameters 


At entry to the IEFU29 exit routine, register 1 points to the four-byte address of 
the ten character data set name of the SMF data set to be dumped. 


( | Return Codes 


Before the IEFU29 exit routine returns control to the control program, it must 
place a return code in register 15. A return code of 4 indicates that the dump 
message, IEE362I or IEE362A, is to be suppressed. A value other than 4 indicates 
that the dump message, IEE362I or IEE362A, is to be issued. 
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Part II — Testing Exit Routines 








Part II describes one method of testing user-written exit routines, the TESTEXIT 
procedure in SYS1.ASAMPLIB. This procedure contains an assembler language 
source program (also named TESTEXIT) which attaches the data generator utility 
program (IEBDG) to create sample parameter lists for all user-written exit 
routines except IEFU29. (The TESTEXIT procedure creates the parameter list for 
the IEFU29 exit routine without using the data generator utility program.) The 
source program then calls each user-written exit routine being tested, and passes the 
appropriate parameter list to it. Figure 4-8 illustrates the input/output and control 
flow of the TESTEXIT source program. 
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Figure 4-8. TESTEXIT Input/Output and Control Flow 
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Before using the TESTEXIT procedure: 


1. Fulfill the following user-written exit routine testing requirements: 


e Specify a user subpool (0-127) in all GETMAIN macro instructions included 
in the routines. 
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e Provide a special SMFWTM macro instruction in all routines that use the macro. 
e Place the routines in a partitioned data set. 
2. Obtain the TESTEXIT procedure from SYS!1.ASAMPLIB. 


3. Modify the procedure to meet the installation’s testing requirements. 


TESTEXIT Exit Routine Requirements 


Before using the TESTEXIT procedure, fulfill the following exit routine 
requirements: 


e Specify a user subpool (0-127) in all GETMAIN macro instructions included in 
your routines. When testing is completed, specify one of the subpools shown in 


Figure 4-14 for the area used to communicate between exit routines (see Part III, 
“Obtaining Additional Work Areas’). 


e@ Provide a special SMFWTM macro instruction in all exit routines that use the 
macro. The special macro definition writes to the TESTEXIT data set defined by 
the DD statement named MANX. (With the normal SMFWTM macro instruction, 
the data is written to the active SMF data set.) Using this macro definition, then, 
data is processed without accessing the system data on the active SMF data set. 
When testing is completed, remove the macro definition. Figure 4-9 shows the 
SMFWIM macro instruction that is required for using the TEXTEXIT procedure. 





MACRO 
&NAME SMFWTM &MSGAD 
AIF (‘&aMSGAD’ EQ ’’). E1 
AIF (‘&MSGAD’‘ EQ’ (1)’) . BAL 
AIF ("&MSGAD’ (1,1) EQ ‘(’) . REGA 
AGO -LODIT 
.E1 MNOTE ‘*** NO OPERAND SPECIFIED ***’ 
MEXIT 
BAL ANOP 
CNOP 0,4 
&NAME BAL 15,*+8 
LIST DC V(TSMFWTM) 
L 15,0(15) 
BALR 14,15 
MEXIT 
-REGA ANOP 
&NAME LR 1,&MSGAD(1) 
CNOP 0,4 
BAL 15,*+8 
AGO «LIST 
-LODIT ANOP 
&NAME LA 1,&aMSGAD 
CNOP 0,4 
BAL 15,*+8 
AGO «LIST 
MEND 





Figure 4-9. SMFWTM Macro Definitions Required for Using TESTEXIT 


e@ Place the exit routines in a partitioned data set named EXITLIB. Figure 4-10 
shows sample JCL for entering the routines into EXITLIB. 
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//UPDTE JOB MSGLEVEL=1 
// EXEC PGM=IEBUPDTE,PARM=NEW 
/ISYSUT2 OD DSNAME=EXITLIB,VOLUME=SER=231400, 
// UNIT=3350,SPACE=(TRK,,(10,3,1)),DISP=(,KEEP), 
i DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
/ISYSPRINT DD SYSOUT=A 
LISYSIN DD DATA 
/ ADD NAME=IEFUJV 
(IEFUJV object deck) 
. ADD NAME=IEFUJI 
(IEFUJI object deck) 
/ ADO NAME=IEFUSI 
(1EFUS! object deck) 
/ ADD NAME=IEFUTL 
(1EFUTL object deck) 
/ .ADD NAME=IEFUSO 
(1EFUSO object deck) 
/ ADO NAME=IEFU83 
(1EFU83 object deck) 
/ ADD NAME=IEFACTRT 
(IEFACTRT object deck) 
/ ADD NAME=lIEFUJP 
(IEFUJP object deck) 
/ ADD NAME=!IEFU29 
ve (IEFU29 object deck) 

( . ADD NAME=|IEFU84 
(1EFU84 object deck) 
/ ENDUP 
/* 


Figure 4-10. Sample JCL for Entering User-Written Exit Routines into EXITLIB 


Obtaining TESTEXIT from SYS1.ASAMPLIB 


Figure 4-11 shows sample JCL for obtaining a punched deck of TESTEXIT from 
SYS1.ASAMPLIB. | 





//PUNCH JOB MSGLEVEL=1 

I EXEC PGM=IEBPTPCH 

/ISYSPRINT DD SYSOUT=A 

IISYSUT1 DD DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 
// UNIT=xxxx,VOLUME=SER=xxxxxx2 

//SYSUT2 DD UNIT=2540-2 

/ISYSIN DD * 


PUNCH TYPORG=P0 MAXNAME=1,MAXFLDS=1 
MEMBER NAME=TESTEXIT 
RECORD FIELD=(80) 

/* 





1The volume and unit parameters depend on your installation’s request. 


Figure 4-11. Sample JCL for Obtaining a Punched Deck of TESTEXIT 
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Modifying the TESTEXIT Procedure 


Figure 4-12 shows sample JCL for executing the TESTEXIT procedure. 





/(TESTEXIT _ JOB §MSGLEVEL=1 

/[TEST | EXEC ASMFCL 

//ASM.SYSIN DD * 

(TESTEXIT Source Module) 

i* 

/[LKED.SYSLMOD DD DSNAME=TESTLIB,VOLUME=SER=335000, 
// UNIT=3350,SPACE=(TRK, (5,2,1)), 

// DISP=(NEW,KEEP) 

//LKED.EXITS DD DSNAME=EXITLIB,VOLUME=SER=335000, 
// UNIT=3350,DISP=OLD 

//LKED.SYSIN DD * 


INCLUDE EXITS(IEFUJV,EFUJI,IEFUSI,IEFUTL,IEFUSO, 
l\EFU83, IEFACTRT JEFUJP,IEFU29,1EFU84) 

ENTRY TESTEXIT 

NAME TESTEXIT 


/* 

/IDATAGEN JOB MSGLEVEL=1 

// EXEC PGM=IEBGENER 

IISYSUT2 DD DSNAME=DGINPUT,UNIT=3350,DISP=(,KEEP),. 
// VOLUME=SER=335000,SPACE=(TRK,(10,5,1)), 
// | DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
/ISYSPRINT DD SYSOUT=A 

/ISYSIN DD * DLM=XX 

GENERATE MAXNAME=9,MAXGPS=0 

MEMBER NAME=UJV 

RECORD _—s IDENT=(6,’ENDUJV’,1) 

MEMBER NAME=UJI 

RECORD _ IDENT=(6,’ENDU4JI’,1) 

MEMBER NAME=USI 

RECORD = IDENT=(6,’ENDUS1I',1) 

MEMBER NAME=UTL 

RECORD _— IDENT=(6,‘ENDUTL’,1) 

MEMBER NAME=U83 

RECORD _ IDENT=(6,'ENDU83’,1) 

MEMBER NAME=ACT 

RECORD = _— IDENT=(6,‘ENDACT’,1) 

MEMBER NAME=USO 

RECORD  IDENT=(6,‘ENDUSO’,1) 

MEMBER NAME=UJP 

RECORD _— IDENT=(6,’ENDUJP’,1) 

MEMBER NAME=U84 : 

me ECORD  IDENT=(6,'ENDU84’,1) 

//SYSUT1 DD DATA,DLM=YY 


DSD OUTPUT=(OUTUJV) 

(1EBDG Control Statements for IEFUJV) 
ENDUJV END | 

DSD OUTPUT=(OUTUJI) 

(IEBDG Control Statements for |EFUJ!) 
ENDUJI END . 

DSD OUTPUT=(OUTUSI) 


ieee (1EBDG Control Statements for |EFUS!) 
relent eeneeemeenemnene nner 


_ Figure 4-12. Sample JCL for Executing TESTEXIT (Part 1 of 3) 
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( ENDUSI 
ENDUTL 
ENDU83 
ENDACT 
ENDUSO 


ENDUJP 


ENDU84 
YY 
IITESTING 
//JOBLIB 
I 

Il 


END 

DSD OUTPUT=(OUTUTL) 

(1EBDG Control Statements for |EFUTL) 
END 

DSD OUTPUT=(OUTU83) 

(1EBDG Control Statements for IEFU83) 
END 

DSD OUTPUT=(OUTACT) 

(1EBDG Control Statements for IEFACTRT) 
END 

DSD OUTPUT=(OUTUSO) 

(1EBDG Control Statements for IEFUSO) 
END 

DSD OUTPUT=(OUTUUJP) 

(1EBDG Control Statements for [E FUJP) 
END 

DSD OUTPUT=(OUTU84) 

(1EBDG Control Statements for IE FU84) 
END 


JOB MSGLEVEL=1 

DD DSNAME=TESTLIB,VOLUME=SER=335000, 
UNIT=3350,DISP=(OLD,KEEP) 

EXEC PGM=TESTEXIT, 


I! PARM='UJV=25,UJ!=8,USI=8,USO=5,UTL=5,U83=12, ACT=2,UJP=2,U29=2,U84=12' 


[INUJV 
// 

Hf 
/IINUSI 
/ 

H 


a /INUSI 
| // 
. 4 


/IWNUSO 
/ 

// 
/IINUTL 
/ 

i! 
/I1INU83 
I! 

// 
/IINACT 
/ 

// 
/IINUJP 
/ 

// 
/IINU84 
// 

// 


DD DSNAME=DGINPUT(UJV),DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB) ,DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 

DD DSNAME=DGINPUT(UJ!),DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 

DD DSNAME=DGINPUT(USI) ,DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350, VOLUME=SER=335000 

DD DSNAME=DGINPUT(USO),DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 

DD DSNAME=DGINPUT(UTL) DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB) DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 

DD DSNAME=DGINPUT(U83) ,DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 

DD DSNAME=DGINPUT(ACT) DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB) DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 

DD DSNAME=DGINPUT(UJP),DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 

DD DSNAME=DGINPUT(U84),DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350, VOLUME=SER=335000 





Figure 4-12. Sample JCL for Executing TESTEXIT (Part 2 of 3) 
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//OUTUJV DD DSNAME=UJV(OUT),UNIT=3350,DISP=(,PASS), 

I SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

I - DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 

HOUTUSI DD DSNAME=UJI(OUT),UNIT=3350,DISP=(,PASS), 

I SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

If DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 

//OUTUSI DD DSNAME=(USI(OUT),UNIT=3350,DISP=(,PASS), 

| SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

iT DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 

/1OUTUSO DD DSNAME=(USO(OUT),UNIT=3350,DISP=(,PASS), 

// SPACE=(TRK(10,5,1)), VOLUME=SER=335000, 

Wl DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 

/HOUTUTL DD DSNAME=UTL(OUT),UNIT=3350,DISP=(,PASS), 

// SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

// DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 

//OUTU83 DD DSNAME=U83(OUT),UNIT=3350,DISP=(,PASS), 

i SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

// DCB=(LRECL=130,BLKSIZE=130,RECFM=FB) 

/IOUTACT DD DSNAME=ACT(OUT),UN!IT=3350,DISP=(,PASS), 

{1 SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

// DCB=(LRECL=180,BLKSIZE=180, RECFM=FB) 

[/OUTUSP DD  DSNAME=UJP(OUT),UNIT=3350,DISP=(,PASS), 

I SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

i DCB=(LRECL=130,BLKSIZE=130,RECFM=FB) 

[//OUTU84 DD DSNAME=U84(OUT),UNIT=3350,DISP=(,PASS), 

I SPACE=(TRK,(10,5,1)), OLUME=SER=335000, 

TT] DCB=(LRECL=130,BLKSIZE=130,RECFM=FB) 

/IMANX DD UNIT=3350, VOLUME=SER=335000,DSN=MANX, 

i SPACE=(TRK,(3,1)),DISP=(NEW,KEEP), 

// DCB=(BLKSIZE=200,LRECL=196) 

/ISYSPRINT DD SYSOUT=A,DCB=(BLKSIZE=136,LRECL=132) 

//DGPRINT DD SYSOUT=A 

/ISYSABEND DD SYSOUT=A a 

dg : 
ee 


Figure 4-12. Sample JCL for Executing TESTEXIT (Part 3 of 3) 


A summary of the operations performed by the procedure shown in Figure 4-12 


is aS follows: 


e The TESTEXIT job assembles the TESTEXIT source program (not illustrated in 
the figure) and link-edits it with the exit routines being tested. (Note that the 
exit routines must reside in EXITLIB, a partitioned data set.) 


@ The DATAGEN job, using the IEBGENER utility program, creates a partitioned 
data set (DGINPUT) containing control statements for the IEBDG utility program, 
which will be attached by the TESTEXIT source program. 


e@ The TESTING job includes the execution of the TESTEXIT source program. 


Use the TESTEXIT procedure provided in SYS1.ASAMPLIB to link-edit the 
sample exit routines in SYS1.ASAMPLIB, generate sample parameter lists, and test 
the sample exit routines. To adapt the TESTEXIT procedure to your installation’s 
testing requirements, however, note the following modifications: 


e The TESTEXIT job shown in Figure 4-12 link-edits the TESTEXIT source 
program with the exit routines. The TESTEXIT procedure in SYS1.ASAMPLIB 
contains ten exit names in the INCLUDE statement. However, when you use 
the TESTEXIT procedure your INCLUDE statement should contain only the 


names of the exit routines you are testing. 
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@ The DATAGEN job shown in Figure 4-12 creates a partitioned data set containing 
the IEBDG control statements that generate samples of standard parameter lists. 
The TESTEXIT procedure contains the control statements for nine exits. Note 
that control statements are not required for the IEFU29 exit routine because the 
TESTEXIT procedure creates the parameters needed to test that routine. When 
using the TESTEXIT procedure you should include only those statements 
needed for the routine you are testing. When testing for special conditions or 
required additional test parameters, you must make appropriate modifications 
and additions to the control statements. 

Note that you must supply control statements in such an order that the records 
subsequently generated by the IEBDG utility program will be grouped as complete 
parameter lists that conform in length and format to the exit parameters previously 
defined in this chapter. (Be sure to include the entry code passed to exits IEFUTL 
and IEFACTRT in register 0 as a one-byte parameter at the end of the parameter 
lists for those exits.) For detailed information on the use of IEBDG control 
statements, see Utilities. 


@ The TESTING job shown in Figure 4-12 includes the execution of the TESTEXIT 
source program. Values for the PARM parameter of the EXEC statement specify 
which exit routines are to be tested and the number of times each is to be tested. 
The TESTEXIT procedure in SYS1.ASAMPLIB contains the parameters to test 
ten exits. However, when you use the TESTEXIT procedure you should include 
only the parameters for the routines you are testing. This parameter has the 
format: 


PARM=‘xxx=nnn,..., XxxX=nnn’ 





where: 


XXX 
is an exit routine identifier. 


nnn 
is the number of times an exit routine is to be tested (the maximum value is 
255). 


The DD statements to be included depend upon the exit routines being tested. 
The TESTEXIT procedure contains DD statements for nine exits as shown in the 
sample (Figure 4-12). When you use the TESTEXIT procedure you should include 
only the DD statements for exits you are testing. DD statements are not required 
for the IEFU29 exit. Figure 4-13 shows the exit-routine identifiers, specified on the 
EXEC statement, and the DD statements that you must include for each exit 
routine being tested. 
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JEFUJV | uv INUuV, OUTUJV 
lEFUJI | UE] INUJI, OUTUJI | 


|EFUSI | ust —s | so INUSI, OUTUSI | 
[EFUTL INUTL, OUTUTL 


(EFUBA 
[teruz [uz | Notreuied SSSC~C 
[Can |__| WAN, SYSPRINT, OGPRINT, SYSABEND 


Figure 4-13. Parameters and DD Statements for Executing TESTEXIT 


UJV 
UJI 
USI 


Note that you must include DD statements for any other data sets used by the exit 
routines in the JCL for the TESTEXIT procedure. | 


4-32 System Management Facilities (SMF) 
































( : Part III — Exit Routine Facilities 


Part III describes the facilities available to user-written exit routines. The following 
macro facilities are described later in Part III: 


e IFASMFR 
e SMFWTM 
e SMFEWTM 
e SMFRTEST 
e SMFEXIT 
e SMFINTVL 
e SMFDETAL 
e SMFSUBP 
e SMFCHSUB 


Part III also details how user-written exit routines can communicate with each other 
and how to obtain additional work areas. For more information on the facilities that 
apply to a specific exit routine, see that exit routine described in Part I of this 
chapter. 


Communicating Between Exit Routines 


( | User-written exit routines can communicate with each other in two ways: by using 
. the user-communication field or by using the user-identification field. Both of these 
fields are contained in the common exit parameter area, which is passed to all user- 
written exit routines except IEFU83, IEFU84, and IEFU29. 


All exit routines (except IEFU83, IEFU84, and IEFU29) that are executing within. 
the same job can communicate via the user-communication field (displacement 32 in 
Figure 4-4) and the user-identification field (displacement 20 in Figure 4-4). Either 
data or the address of a data area can be placed in the communication field. How- 
ever, passing the address of a data area can cause a problem. For example, assume 
the user exit IEFUJV runs on the global processor with JES3. The exit issues a 
GETMAIN, and stores the address of the data area in the user communication 
field. Unless the related job runs on the same processor, it will terminate 
abnormally. The same problem can occur if a system restart occurs after IEFUJV 
sets the address but before the related job tries to use the address. Additionally, jobs 
that are requeued for execution or warm started through the $E command also contain 
invalid data. 


Notes: 


1. The user-communication field is initialized to zeros by the job entry subsystem 
each time a job begins execution; the user-identification field is initialized to 
EBCDIC blanks each time a job is read. Neither of these fields is maintained if the 


system is restarted. 


2. If there is communication between exits, use care in creating the SMF parmlib 
members; make sure that all exits involved are included in each member. 
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Obtaining Additional Work Areas 


Any user-written exit routine can obtain an additional work area by issuing a 
GETMAIN macro instruction that specifies an appropriate subpool. Figure 4-14 | 
shows the subpools (and their characteristics) that are required to obtain additional 
work areas. Be sure to consider the storage required by an additional work area 
when estimating the sizes of the common service area (CSA), system queue area 
(SQA), and local system queue area (LSQA). 


Subpool | Area in | 
Number Storage Attributes of Subpool - 


‘Private ‘User protection key Automatically freed at task 
Area ~ Pageable termination. Assigned 
Storage Fetch-protected from top of private area. 







































































Private 
Area 
Storage 


Automatically freed at task 
termination. Assigned 
from top of private area. 


User protection key 
Pageable 
Not fetch-protected. 










Explicitly freed Because subpool 231 is fetch- 


Pageable protected, use it for exit 

F etch-protected communication only among exits of 
System-oriented the same key (see Figure 4-3). 

User Key 












Explicitly freed Because SMF exit routines receive 








Pageable control in different keys (see Je 
Not fetch-protected Figure 4-3), and subpool 241 is not 
System-oriented fetch-protected, use it for read ae 
User key access from ail exits... 







Allows a task running in key 0 to 
acquire non-accountable, fixed, 
protected storage that is systern- 
oriented. 


Explicitly freed 
Fixed 

Not fetch-protected 
System-oriented 
Key=0 


Automatically freed at end 
_ of task 








Allows a task running in key 0 to 
acquire fixed, accountable, 














related) Fixed protected storage in the LSQA for 
Not fetch-protected the user’s region that is job-oriented 
Job-oriented and freed when the task terminates. 
Key=0 


Swappable 

























LSQA Automatically freed at end | Allowsa task running in key 0 to 
(step- of step acquire fixed, accountable, 
related) Fixed protected storage in the LSQA for 
Not fetch-protected the user’s region that is job-oriented 
Job-oriented and freed when the job step 
Key=0 terminates. 
Swappabie 















Allows a task running in key 0 to 
acquire fixed, non-accountable, 


Explicitly freed 
Fixed 


Not fetch-protected protected storage in the LSQA that 
Job-oriented is job-oriented and must be 
Key=0 explicitly freed. 


Swappable 


Figure 4-14. Required Subpools for Obtaining Additional Work Areas 
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( : Using the IFASMFR Macro to Address SMF Record Fields 


Use the IFASMFR macro instruction in user-written exit routines (or in any 
problem program application) to symbolically address SMF record fields. The 
macro instruction is written in assembler language and is supplied on 
SYS1.AMODGEN. Depending on your installation’s requirements, you may want 

to copy the IFASMFR macro from SYS1.AMODGEN into your own macro library 
or SYS1.MACLIB. Note that the IFASMFR macro is distributed as 14 submacros: 
IFASMFR, IFASMFR1, IFASMFR2, ... IFASMFR9, IFASMFRA, . .. 
IFASMFRD. 


The format of the IFASMFR. macro is: 





IFASMFR n 


where: 


n 


is the record type to be defined. You must specify at least one record type 
with the macro; if more than one record type is specified, you must enclose the 
record types in parentheses and spearate them by commas. The values for n 
can be: 0, 2-11, 14, 15, 17-23, 24 (JES2 only), 25 (JES3 only), 26, 30-32, 34, 
35, 36, 37, 39, 40, 41, 43, 45,46, 47-49, 52-59, 62-64, 80-81,90. For records 
not listed, see the description of the record in “SMF Records.” 


( Notes: 

1. The “Name” column in all the SMF record formats (see the chapter “SMF 
Records’’) contains the symbolic addresses defined by the IFASMFR macro 
instruction. 

2. Do not specify both record type 14 and record type 15 in the same program. 
Because these records are identical, whenever record type 15 is specified in the 
IFASMFR macro, record type 14 is defined. 

3. If you do not want the IFASMFR macro to use part of the problem program’s 
storage, then supply a CSECT or DSECT statement ahead of the macro 
instruction. (If you invoke the IFASMFR macro within a DSECT, multiple 
record types are mapped contiguously. That is, each record type will not have 
a zero origin). 

4. To address SMF record fields for record types 36, 60, 61, 65, and 66, use the 
IFASMF16 macro instruction instead of IFASMFR macro instruction. 

5. To generate the JES SMF record mappings, IFASMFR invokes the IAZSMFR 
macro. Both IFASMFR and IAZSMFR should reside on macro libraries used 
in your SYSLIB concatenation. IAZSMFR is supplied on SYS1.MACLIB and 
is distributed as 14 submacros: [AZSMF24, 25, 26, 43, 45, 47, 48,52... 58. 
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Using the SMFWTM Macro to Write Records : —_ 


Use the SMFWTM macro instruction to write records to the SMF data set. The 
address of each record to be written must be less than 16 megabytes. If the address 
is greater than 16 megabytes, the routine that issued SMFWTM abends with an 
X‘353’ system completion code. You can use this macro in any exit routine that 
has a storage protect key of zero except IEFU83 and IEFU29 (see Figure 4-3), and 
in any installation problem program that has an APF authorization. The SMFWTM 
macro is written in assembler language and is supplied on SYS1 MACLIB. Its 
format is: 


[label] SMFWTM { record address | (r) } 


where: 
record address 
is the symbolic address of the record to be written. 


(r) 
is a register containing the address of the record to be written. The value 
for (r) can be either the absolute register number or a symbol for the 
register. In either case, you must code the parentheses, for example, (2) or 
(REG2). 


Record types 128 through 255 are available for user-written records. When using 
the SMFWTM macro instruction to write user records, you must provide the standard 
SMF record header, which includes a record descriptor word (RDW) for the record. ees 
You must also fill in the date, time, and system identifier in the record header. While aed 
the system identifier can be any four character identifier, specifying the SMCASID 
is consistent with the system records SMF produces. (For a description of the 
standard SMF record header, see the chapter ““SMF Records” in this book. For a 
description of the RDW, see Data Management Services.) 


Record types 0 through 127 are SMF-formatted records. For all SMF-formatted 
records you must supply: 


@ The RDW (offsets 1 and 2 in Figure 6-1 and 6-2) 
e The record type field in the standard SMF record header (offset 5 in Figure 6-1 and 
Figure 6-2) 


The SMFWTM macro supplies the remaining header information. 


All SMF records are given to user exit IEFU83 before they are written to the SMF 
data set. 


The SMFWTM macro instruction returns a code in register 15 that indicates the 
record’s status, as follows: 
e 0 indicates the record was written without error. 


@ 8 indicates the record was not written because the length specified in the RDW 
was less than 18 bytes. 


e 16 indicates the record was not written because SMF is not active. 
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Using the SMFWTM Macro to Write Records (continued) 


e 20 indicates the record was not written because the user-written IEFU83 exit 
routine suppressed the record. 


e 24 indicates that the record was not written because the data was lost. 


e 36 indicates that the record was not written because the record specified is 
not currently being recorded. 


e@ 40 indicates that the record was not written because a buffer storage 
caused the data to be lost 


° 44 indicates that the record was not written because SVC 83 was unable to 
establish recovery. 


Using the SMFEWTM Macro to Write Records 


Use the SMFEWTM macro instruction to write records to the SMF data set. The 
address of each record to be written must be less than 16 megabytes. If the address 


‘is greater that 16 megabytes, the routine that issued SMFEWTM abends with an 


X‘353’ system completion code. You can use this macro in any exit routine that 

is in supervisor state except IEFU83, IEFU84, and IEFU29 (see Figure 15), and 

in any installation problem program that has APF authorization. The SMFEWTM 
macro verifies that SMF recording is active and allows the issuer to branch directly 

to the SVC routine without issuing the SVC. When you invoke SMFEWTM, the macro 
makes reference to two fields SMCAMACR and SMCABASE found in the SMCA con- 
trol block. Because SMF uses this control block as a major communication area, you 
can check these two SMCA fields to determine if SMF is active. The SMFEWTM 
macro is written in assembler language and is supplied on SYS1 .MACLIB. Its format is: 


rr 


[label] SMFEWTM [rec addr} | J-BRANCH=NO 
,BRANCH=YES 


eee: 


»UBSYS=name WRKAREA=addr 
,SUBSYS=(reg) WWRKAREA+=(reg) 


The parameters are: 


rec addr 
specifies the address or the register (2)-(12), that contains the address of the 
record to be written. | 


,;BRANCH=NO 

,BRANCH=YES 
specifies the entry method to the SVC routine. If BRANCH=NO is specified, 
the macro generates an SVC 83. If BRANCH=YES is specified, the macro 
generates a call to the subroutine that moves the data to the SMF buffer. To 
use BRANCH=YES the caller must be in supervisor state, have a protection 
key of zero, and set register 13 to point to a standard 72-byte save area. 


Chapter 4: Part II — Exit Routine Facilities 4-37 





FoR SES Ee RR RES eT A AA a a 


PEE a ee re 











All SMF records are given to user exits before they are written to the SMF 
data set. If you specify BRANCH=NO (or use the SMFWTM macro), user 
exit IEFU83 is invoked. If you specify BRANCH=YES, user exit IEFU84 
is invoked. 


Notes: If you are currently using the SMFWTM macro to write SMF records 
and change to the SMFEWTM macro, BRANCH=YES, then the SMF 
records are given to user exit IEFU84 (rather than user exit IEFU83). 


»SUBSYS=name 

SUBSYS=(reg) | 
specifies the one to four character subsystem name or register (2)-(12) that con- 
tains the address of the four byte subsystem name. The subsystem name must 
be left-justified and padded with blanks. If a register is used, the register must 
be enclosed in parentheses. 


If SUBSYS is not specified, the subsystem name for the current address space 
is used. For example, TSO for TSO users, STC for started tasks, and the name 
of the job entry subsystem (JES2 or JES3) for batch jobs. 


The subsystem name is compared with the list of subsystems specified in 
SMFPRMxx. If the subsystem is listed in SMFPRMxx, the options for that sub- 
system are used to determine if the record is written. Otherwise, the options 
specified for the entire system by means of the SYS option are used. 


;WRKAREA=addr 

;WRKAREA=(reg) 
specifies the address or a register (2)—(12) that points to a five-word work area 
that you must supply for SMF to use. If a register is specified, the register must 
be enclosed in parentheses. WRKAREA must be specified if SUBSYS is 
specified. 


Record types 0 through 127 are SMF-formatted records. For all SMF-formatted 
records you must supply the RDW: 


e The RDW (offsets 1 and 2 in Figure 6-1 and 6-2) 


e The record type field in the standard SMF record header (offset 5 in Figure 6-1 
and 6-2) 


The SMFEWTM macro supplies the remaining header information. 


Record types 128 through 255 are available for user-written records. When 
using the SMFEWTM macro instruction to write user records, you must provide the 
standard SMF record header, which includes a four-byte record descriptor word 
(RDW) for each record. You must also fill in the date, time, and system identifier 
in the record header. While the system identifier can be any four character identifier, 
specifying the SMCASID is consistent with the system records SMF produces. 
(For a description of the standard SMF record header, see the chapter “SMF 
Records” in this book. For a description of the RDW, see Data Management 
Services.) : 


4-38 System Management Facilities (SMF) 





i 

















( a | Using the SMFEWTM Macro to Write Records (continued) 


The SMFEWTM macro instruction returns a code in register 15 that indicates the 
record’s status, as follows: | 


indicates the record was written without error. 


e 8 indicates the record was not written because the length specified in the 
RDW was less than 18 bytes. 


indicates the record was not written because SMF is not active. 


e @ 
tO — 
Oo AO 


indicates the record was not written because the user-written IEFU83 or 
JEFU84 exit routine suppressed the record. 


eo 
to 
iN 


indicates that the record was not written because the data was lost. 


e 
WW 
On 


indicates that the record was not written because the record type specified 
is not currently being recorded. 


indicates that the record was not written because a buffer shortage caused 
the data to be lost. 


@ 
iN 
on) 


indicates that the record was not written because SVC 83 could not 
establish recovery. 


iS 


Using the SMFRTEST Macro to Test Record Recording 


The SMFRTEST macro instruction allows a user to determine if a particular type of 
ce record is being recorded. This macro should be issued before collecting data for a 
( record to avoid the overhead of data collection if the record is not written. The 
syntax is as follows: 





[label] SMFRTEST RECTYPE= <7°°OO’ | supsys= name 
(reg) (reg) 





The parameters are: 


‘RECT YPE=record 

RECTYPE=(reg) | 
specifies the SMF record type to be checked, where record can be any one to 
three decimal digits (0-255). If reg is specified, the register (2)-(12) contains 
the record type. The record type must be right-justified within the register. 


SUBSYS=name 

SUBSYS=(reg) 
specifies the one to four character subsystem name or register (2)~(12) that 
contains the address of the four byte subsystem name. The subsystem name 
must be left-justified and padded with blanks. Ifa register is used, the register 
must be enclosed in parentheses. 


If SUBSYS is not specified, the subsystem name for the current address space 
is used. For example, TSO for TSO users, STC for started tasks, and the name 
of the job entry subsystem (JES2 or JES3) for batch jobs. | 
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Using the SMFRTEST Macro to Test Record Recording (continued) 


a 


f 


The subsystem name is compared with the list of subsystems specified in 
SMFPRMxx. If the subsystem is listed in SMFPRMxx, the options for that sub- 
_ system are used to determine if the record type is selected. Otherwise, the 
options specified for the entire system through the SYS option are used. 


When the macro returns control, register 15 contains one of the following return 
codes: 


Code Meaning 
00 The record type is being recorded. 
16 SMF is not active. 


36 Information is not being collected for the specified record type. 


Note: Registers 14 and 15 are used by the macro and are not reset. On entry to 
the macro, register 13 must point to a 72-byte save area. 


Using the SMFEXIT Macro to Branch to the SMF Exits 


The SMFEXIT macro instruction allows the user to branch directly to any user- 
written SMF exit that resides in the SYS1.LPALIB. The SMF exit name must have 
been defined to SMF with the EXIT parameter before the macro instruction is 
issued. go 


The syntax is as follows: 





[label] SMFEXIT exitname [sussys- ah [. WRKREG=(reg) ] 


The parameters are: 


exitname 
specifies the load module name of the exit. 


SUBSYS=(reg) 

»SUBSYS=name 
specifies the one to four character subsystem name or register (2)-(12) that 
contains the address of the four-byte subsystem name. The subsystem name 
must be left-justified and padded with blanks. If a register is used, the register 
must be enclosed in parentheses. 


If SUBSYS is not specified, the subsystem name for the current address space 
is used. For example, TSO for TSO users, STC for started tasks, and the name 
of the job entry subsystem (JES2 or JES3) for batch jobs. 


The subsystem name is compared with the list of subsystems specified in 
SMFPRMxx. If the subsystem is listed in SMFPRMxx, the options for that sub- 
system are used to determine if the exit is to be invoked. Otherwise, the options fo 
specified for the entire system through the SYS option are used. a, 
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( 7 : Using the SMFEXIT Macro to Branch to the SMF Exits (continued) 


,WORKREG=(reg) 
specifies a register that is intended for exits that run in 31-bit addressing mode. 
SMF uses this register to save and restore the caller’s addressing mode and 
return address. If you do not specify this parameter, the default is register 2. 


On entry to the macro, register 13 must point to a 72-byte save area. Parameters 
can be passed to the exit in register 0 or 1; the parameters must be placed in the 
registers before the macro is invoked. 


When control returns to the issuer, a return code of zero in register 15 indicates 
‘that the exit was not invoked either because SMF is not active, or because the exit 
is not active for the requesting subsystem. When the exit is invoked, the user-exit 
routine can place a return code in register 15. For more information see the 

section, “User-Written Exit Routines’’. 


Using the SMFINTVL Macro to Determine Interval Time 


The SMFINTVL macro instruction allows the user to determine the current 
INTERVAL value specified for a subsystem. A user subsystem could use this value 
to set up interval recording for a subsystem and MVS supervisor services to set up 
the timer value. For example, MVS uses this macro to determine how often to 
write interval type 30 records to SMF. | 





( 7 The format is: 


[label] SMFINTVL (interval) | sussys- = \ 
name 





The parameters are: 


interval 
specifies a register (2)-(12). When the macro returns control, this register con- 
tains the address of an eight-byte area that contains the interval value. The 
interval value is an unsigned 64-bit fixed-point number, where bit 51 is 
equivalent to 1 microsecond. 


SUBSYS=name 

SUBSYS=(reg) 
specifies the one to four character subsystem name or register (2)-(12) that 
contains the address of the four-byte subsystem name. The subsystem name 
must be left-justified and padded with blanks. If a register is used, the register 
must be enclosed in parentheses. | 


If SUBSYS is not specified, the subsystem name for the current address space 
is used. For example, TSO for TSO users, STC for started tasks, and the name 
of the job entry subsystem (JES2 or JES3) for batch jobs. 


The subsystem name is compared with the list of subsystems specified in 
SMFPRMxx. If the subsystem is listed in SMFPRMxx, the options for that — 
subsystem are used to determine the length of the interval. Otherwise, the 
options specified for the entire system through the SYS option are used. 
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Using the SMFINTVL Macro to Determine Interval Time (continued) 


When the macro returns control, register 15 contains one of the following return 
codes: 





Code | Meaning 


00 (interval) contains the address of the interval value. 
| 04 There is no interval time defined. The contents of (interval) are 
| unpredictable. 

16 SMF is not active. The contents of (interval) are unpredictable. 


| Using the SMFDETAL Macro to Test Detail Recording 


| The SMFDETAL macro instruction is used to determine if detail recording is active 

for the current subsystem. A user subsystem could use this macro to determine 

| what level of data to collect. For example, TSO uses SMFDETAL to determine if 
type 32 detail data or type 32 summary data is to be collected. 


The syntax is as follows: 


[label] SMFDETAL |(suBsys= 272°, 
(reg) 


The parameters are explained below: 











SUBSYS=name 
SUBSYS=(reg) 

specifies the one to four character subsystem name or register (2)-(12) that 
| contains the address of the four byte subsystem name. The subsystem name 
must be left-justified and padded with blanks. If a register is used, the register 
must be enclosed in parentheses. 


If SUBSYS is not specified, the subsystem name for the current address space 
is used. For example, TSO for TSO users, STC for started tasks, and the name 
of the primary job entry subsystem (JES2 or JES3) for batch jobs. 


The subsystem name is compared with the list of subsystems specified in 
SMFPRMxx. If the subsystem is listed in SMFPRMxx, the options for that 
subsystem are used to determine if detail level data is requested. Otherwise, the 
options specified for the entire system through the SYS option are used. 


When the macro returns control, register 15 contains one of the following return 
codes: 


Code Meaning 


00 Detail recording is in effect. 
04 Detail recording for the subsystem is not in effect. 
16 SMF is not active. 
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Using the SMFSUBP Macro to Determine Subsystem Parameters 


An installation specifies a parameter string for a specific subsystem on the 
SUBPARM parameter in the SMF parmlib member. A user-defined subsystem 
issues the SMFSUBP macro instruction during subsystem initialization or after 
the subsystem interface call generated by a SET or SETSMF operator command. 


The syntax is as follows: 


(label) SMFSUBP addr | sunsys- hee \ | 
name 


The parameters are: 
addr 


specifies a register (2) — (12). When the macro return control, this register 
contains the address of the 60-byte information string followed by a four- 
byte field that contains: 


e the length of the field in the first two bytes 
@ The source flags in the third byte. They are as follows: 


Bit Meaning when Set 
0 SMF is active 
1 Reserved 
2 Information string was issued by parmlib member 
3 Information string was issued by operator reply 
4 Information string was issued by default 
5 Information string was changed due to conflicts or 
errors 
6 Information string was changed by IPL, SET, or SETSMF 
7 Reserved 


e@ The console identifier in the remaining byte 


SUBSYS=(reg) 

UBS YS=name 
specifies the one to four character subsystem name or register (2)}-(12) that 
contains the address of the subsystem name. If a register is used, the register 
must be enclosed in parentheses. If SUBSYS= is not specified, the address of 
the SUBPARM value for the subsystem name of the current address space is 
returned. 


When the macro instruction returns control, register 15 contains one of the 
following return codes: 


Code Meaning 
0 Successful completion of the macro 
4 No SUBPARM parameters are entered for the specified 
subsystem. 
16 SMF is not active. 
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Using the SMFCHSUB Macro to Change Subsystem Parameters 


A user-defined subsystem issues the SMFCHSUB macro instruction to change the 
information string specified in the current SUBPARM parameter. A user-defined 
subsystem issues this macro instruction when the subsystem determines that an error, 
such as a spelling error, exists in the information string. Issuing the macro instruction 
to correct the error causes the SMF options to be displayed correctly on the opera- 
tors console. 


The syntax is as follows: 





(label) SMFCHSUB SUBSYS= ‘ sais suBPARM{ Si i 


The parameters are: 


SUBSYS=name 

SYBSYS=(teg) 
specifies the one to four character subsystem name or register (2) — (12) that 
contains the address of the subsystem name. If a register is used, the register 
must be enclosed in parentheses. If SUBSYS= is not specified, the SUBPARM 
value (if one exists) for the subsystem of the current address space is changed. 


SUBPARM=(reg) 

SUBPARM=addr 
specifies the address of a 60-byte area or a register (2) — (12) that contains the 
address of the 60 bytes that is to replace the current SUBPARM value for the 
specified subsystem. 


When the macro returns control, register 15 contains one of the following return 


codes. 
Code Meaning 
0 Successful completion of the macro instruction. 
4 No SUBPARM value found; thus, the value was not 
changed. 
8 A SETSMF or a SET command is currently being pro- 


cessed. SUBPARM is not changed for this request. 
The subsystem can reissue the macro instruction. 

12 A DISPLAY command for SMF is currently being pro- 
cessed. SUBPARM is not changed for this request. The 
subsystem can reissue the macro instruction. 

16 SMF is not active. 
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( Chapter 5: User-Written Report Programs 


The SMF dump program (IFASMFDP) can be used to create data sets containing 
certain record types. In addition, the dump program produces a summary activity 
report. In some cases, an installation may wish to produce their own report. 
Producing a report usually requires at least two operations: sorting the SMF 
records and writing them in an appropriate format. 


For those installations choosing to read the SMF data sets directly rather than 
using the dump program, note that the SMF data sets are preformatted with dummy 
records. A dummy record is shorter than any valid SMF record and is easily 
identified because it contains the characters ‘SMFEOFMARK’. The SMF dump 
program terminates processing when it encounters a dummy record, thereby 
improving data set processing performance, 





Sorting SMF Records 


Any sort/merge program can be used to sort SMF records; this section describes two 
sample sort/merge exit routines that you may use with the IBM OS/VS Sort/Merge 
Program Product (Program No. 5740-SM1). (For a detailed description of this 
particular sort/merge program, see OS/VS Sort/Merge Programmer’s Guide. ) 


( | Sample Sort/Merge Exit Routines 


The IBM OS/VS Sort/Merge Program Product can, during various phases of 
execution, pass control to routines designed and written to perform specific 
functions. SYS1.ASAMPLIB has two sample routines that receive control from 
exits E15 and E35 of this sort/merge program. The sample E15 exit routine, called 
SMFE15, extracts all SMF records without a job log identification (job name and 
time and date that the reader recognized the JOB card) from the SMF dump data 
set. SMFE15 retains the dump header and dump trailer records (types 2 and 3) in 
the temporary data set HDRDATA. It retains all other system-oriented records 
(records without a job log identification) in the temporary data set SORDATA. 


The sample E35 exit routine, called SMFE35, places all the records extracted by 
the SMFE15 routine in the sort output data set. These records are inserted in the 
data set as follows: dump header records, dump trailer records, all other system- 
oriented records, and the sorted job-oriented records. 


Note: If tape work devices are used, the minimum block length the IBM 

-Sort/Merge Program Product can sort is 18 bytes. Otherwise, the minimum is one 
byte. The sample routines SMFE15 and SMFE35 use SMF record types 0 through 
13 for input; the minimum length of these SMF records is 18 bytes. 
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Figure 5-1 shows sample JCL for obtaining a listing of the SMFE15 and SMFE35 
exit routines from SYS1.ASAMPLIB. Figure 26 also shows sample JCL for obtaining 
a listing of the SYS1.ASAMPLIB member named SMFSORT. SMFSORT contains 
sample JCL for executing the IBM OS/VS Sort/Merge Program Product: 


//PRINT JOB 123456,SMITH 


i EXEC PGM=IEBPTPCH 
HISYSPRINT DD SYSOUT=A 
HISYSUT1 DD DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 
iI | UNIT=xxxx,VOLUME=SER=xxxxxx? 
HISYSUT2 DD SYSOUT=A 
/ISYSIN DD . 
PRINT TYPORG=PO,MAXNAME=4,MAXFLDS=4 


MEMBER NAME=SMFSORT 
RECORD FIELD=(80) 
MEMBER NAME=SMFE15 
RECORD’ FIELD=(80) 
MEMBER NAME=SMFE35 
RECORD FIELD=(80) 

/* 





1The volume and unit parameters depend on your installation’s request. 


Figure 5-1. Sample JCL for Obtaining a Listing of Sample Sort Exit Routines 


To include the sample exit routines in your sort application, you must assemble 
and link-edit them before executing the sort/merge program. Figure 5-2 shows | 
sample JCL for this procedure, including one possible sort application. In this 
example, SMF records are to be sorted first on the job log identification (major 
control field), and then on the time and date portions of the time stamp (minor 
control fields). Displacements of these fields (as shown in the record formats in 
the next chapter) are 14, 6, and 2. Note, however, that you must add an additional 
four bytes for the RDW and one byte for the sort procedures (initial count of 1) 
to these displacements. Hence, displacements 19, 11, and 7 are shown in the 
SORT FIELDS= statement in Figure 5-2. 
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/ISMFSORT 
HISTEP1 
/IASM.SYSIN 


(E15 Source Deck) 
[* 
//LKED.SYSLMOD 
// 


// 
/ILKED.SYSIN 


/* 
/ISTEP2 
I/ASM.SYSIN 


(E35 Source Deck) 
/* 
/(LKED.SYSLMOD 


/ 
/ILKED.SYSIN 


/* 
/ISORTSTEP 
IISYSOUT 
/ISORTLIB 
/(EXITLIB 

// 

//SORTIN 

/ 

//SORTWKO1 

//SORTWKO2 

//SORTWKO3 

//SORTOUT 

H 

/ISORDATA 

// 

/IHDRDATA 

// 

/ISYSIN 
SORT 
MODS 
END 

/[* 


JOB 
EXEC 
DD 


DD 


DO 


NAME 


EXEC 
DOD 


DD 


DD 
NAME 


EXEC 
DD 
DD 
DD 


DD 


MSGLEVEL=1 
ASMFCL} 


¥ 


DSNAME=SMF1.EXITS,UNIT=2314,2 
DISP=(NEW,KEEP) SPACE=(TRK,(10,5,1)), 
VOL=SER=335000 


E15(R)? 


ASMFCL2 


DSNAME=SMF1.EXITS,DISP=(OLD,KEEP) ,@ 
UNIT=3350, VOL=SER=335000 


* 


E35(R)5 


PGM=SORT,REGION=100K4 

SYSOUT=A 
DSNAME=SYS1.SORTLIB,DISP=SHR 
DSNAME=SMF1.EXITS,DISP=(OLD,KEEP),° 
UNIT=3350,VOL=SER=335000 : 
UNIT=2400, VOL=SER=SYSMAN,DISP=OLD, 


LABEL=(,SL),DCB=(RECFM =VBS,LRECL=600,BLKSIZE=200) 7 


DD 
DD 
DD 
DD 


UNIT=3350,SPACE=(TRK,(50), ,CONTIG)® 
UNIT=3350,SPACE=(TRK,(50), ,CONTIG)® 
UNIT=3350,SPACE=(TRK,(50), ,CONTIG)® 
UNIT=2400,DSNAME=SMF1.SORTOUT,LABEL=(,SL),? 


DISP=(,KEEP),DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) 7 


DD 


DD 


DD 


UNIT=SYSDA,SPACE=(CYL,(1,1)),4° 
OCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) ” 
UNIT=SYSDA,SPACE=(TRK,(5,5)) ,2° 
DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) ” 
FIELDS=(19,16,A,11,4,A,7,4,A) FORMAT=BI,SIZE=E4000! 1 
E15=(E15,700,EXITLIB,N),£35=(E35,1500,EXITLIB,N)22 





1EXEC statement for cataloged procedure ASMFCL. (assemble and link-edit). (For a description 
of the ASMFCL procedure, see Assemb/er H Version 2: Application Programming Guide.) 
2The sample sort exit routines will be link-edited into data set SMF1.EXITS. 


3Link-edit control statements specifying that E15 and E35 will be the load module names of the 


exit routines. 


4EXEC statement for the sort/merge program. 
5Data set SMF1.EXITS is specified as the library in which sort exit routines can be found. 


Sinput to the sort program is the SMF dump data set, contained on a tape having a volume 
serial number of SYSMAN. 


’The LRECL value can be larger than the BLKSIZE value because records might be segmented. 
The LRECL value must be as large as the longest SMF record being created plus four bytes for 
the RDW. Modify these parameters according to the longest record to be collected. 
8Three sort work units are defined as being direct access devices. 
°The sort Output data set is to be written on tape. 
10Two data sets required by the sample sort exit routines are defined on direct access devices. 


11The sort/merge control statements define the sort control fields and exit routines to be used 
in this sort application. 


Figure 5-2. Sample JCL for Executing a Sort Procedure 
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Designing a Report Program | \. 


The basic operations of a report program are formatting and printing data from 
SMF records. The input to a report program is normally the sorted SMF data set. 


SYS1.ASAMPLIB has a sample PL/1 source report program, called SMFFRMT. 
which formats record types 23 and 90. Contained within the program are declares 
for record types 23, 30, 32, and 90. Figure 5-3 illustrates a sample SMF activity 
report and an operator tracking report produced by SMFFRMT. 


SMF ACTIVITY REPORT 


TIME 5:01:47 PM DATE 05/03/85 


BUFFERS 
PER MIN 


SYSTEM TIME RECORD 
ID WRITTEN 


RECORDS MAX FULL 
PER SEC BUFFERS 


# USERS 
SUSPENDED 


DATA REC 
WRITTEN 


REC PRODUCT REPORTING RELEASE BUFFERS 
VER NAME INTERVAL NUMBER WRITTEN 


RECORDS 
WRITTEN 


168A 
168A 


10:30:37. 86 
251:03.51 


0.18 
0.06 


01:00:00 
01:00:00 


038 11 208 
038 04 67 


0.05 
0.01 


03/20/79 01 SMF 


SMF 


168A 
168B 
| 168A 
168A 
MINE 


251:03.82 
251303.92 
:37:04.41 
:39:25.11 
2:06:39.15 


03/20/79 01 


03/20/79 
03/20/79 
03/20/79 
01/12/12 
03/20/79 


01 
01 
91 
01 
01 


SMF 
SMF 
SMF 
SMF 
SMF 


01:00:00 
01:00:00 
00:05:00 
01:00:00 
00:01:00 


038 
038 
038 
038 
038 


00 
00 
07 
00 
01 


09 
13 
111 


36 


0.00 
0.00 
1.40 
0.00 
1.00 


0.00 
0.00 
0.37 
0.00 
0.60 


OoO-0 #H0O00 | 9 


MINE 21:07:39.17 03/20/79 01 SMF 00:01:00 038 00 04 0.00 0.06 


TOTAL / AVERAGE 460 


wo 


/ MAXIMUM | 23% 0.07 0.02 


OPERATOR TRACKING REPORT 
TIME 5:01:47 PM 


DATE 05/03/85 


REC PRODUCT 
VER NAME 
01 SMF 


DATE REC 
WRITTEN 
03/20/79 


SYSTEM TIME RECORD 
ID WRITTEN 
168A 12:212:343.12 


SMF OPTIONS AT SET om j 


MIN 
BUFS 


MAX REL 
BUFS NUM 


JOB WAIT TIME SYSTEM 
HH :MM ID 


MAXDORM STATUS 


MM:SS HH:MM:SS IPL DATE 


IPL TIME 


30:00 01:00:00 00:10 168A 4 9 038 11:18:49.88 03/20/79 


PROMPT (ALL) REC (PERM) LISTDSN 


ACTIVE SMF RECORDING DATA SETS 


SYS1.MANC SYS1.MAND 


RECORDING OPTIONS BY SUBSYSTEM 


SYS NAME DETAIL RECORDING INTERVAL 


SYS NOT IN EFFECT * NONE * 


RECORDS COLLECTED FOR THIS SUBSYSTEM (BITS REPRESENT COLLECTABLE RECORDS) 


PFFPFFFFFFFFFPFFFFFFFFFFPFFFFPFFFFFFFFFFFFFPFFFFFFFFFFFFFFFFFFFF 
ACTIVE SMF EXITS FOR THIS SUBSYSTEM 


IEFUTL IEFUSI IEFUJV IEFUJI IEFACTRT IEFU29 IEFU84 IEFU83 


SYS NAME DETAIL RECORDING INTERVAL 


TSO IN EFFECT * NONE * 


RECORDS COLLECTED FOR THIS SUBSYSTEM (BITS REPRESENT COLLECTABLE RECORDS) 


PRFFFFFFFFFFFFFFFFFFFFFFFFFFFFPFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 
ACTIVE SMF EXITS FOR THIS SUBSYSTEM 


IEFU83 IEFU84 IEFU29 IEFACTRT IEFUJI IEFUJV IEFUSI IEPUTL 





Figure 5-3. Sample Output from SMFFRMT 





3-4 System Management Facilities (SMF) 

















Before using the SMFFRMT program, you must compile the program using the 
PL/I compiler. Figure 5-4 shows sample JCL for executing the SMFFRMT program 
after it is compiled and link-edited into SYS1.LINKLIB. 


[/FORMAT JOB MSGLEVEL=1 

//FRMT EXEC PGM=SMFFRMT 

IISYSPRINT DD SYSOUT=A 

//REPORT DD SYSOUT=A 

IISMFDATA DO DISP=(OLD,KEEP), LABEL=(,SL), VOL=SER=xxxxxx,DSN=nnn, 
// UNIT=2400 


Figure 5-4. Sample JCL for Executing SMFFRMT 
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Chapter 6: SMF Records 


This chapter fully describes all of the SMF-formatted records. Note that the fields 
in these records marked “Reserved” are for use by SMF and are not available for 
your use. 


Standard SMF Record Header 


Each record written to the SMF data set by the SMF writer routine contains the 
standard SMF record header. Each user record written to the SMF data set by 
user-written routines should also include the standard record header. The length 
and field types for the record header vary with the kind of record written. Figure 
6-1 illustrates the header for records without subtypes; its length is 18 bytes. 
Figure 6-2 shows the header for records with subtypes; its length is 24 bytes. 


The header contains information about the record such as record type, record 
subtype if the record includes subtypes, record length, and the time and date the 
record was written to the data set. Record subtypes are used to group related data 
and control record types. For example, one record might contain three separate 
subtypes, each reporting different kinds of data; by using those subtypes you can 
eliminate the need for three separate record numbers. When designing your SMF 
record, you should make use of record subtypes efficiently. Many small subtypes 
within a record could create excessive I/O when written to the SMF data set, while a 
larger record with fewer subtypes can help avoid high I/O overhead. 


The header section must include the record descriptor word (RDW). The RDW isa 
4-byte field that must precede an SMF record when it is written to the SMF data 
set by the SMFWTM macro instruction. The first two bytes of the RDW must 
contain the length of the logical record (including the four bytes of the RDW). The 
second two bytes are used for variable blocked spanned records; that is, records 
that contain more than 32,760 bytes. This field (the second two bytes) is set to 
zero if the record is not spanned. For a discussion of the RDW, see Data 
Management Services. 
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(The ‘‘Name’”’ field in all 
of the SMF records 
contains the symbolic 
addresses defined by the 
IF ASMFR macro 
instruction. ) 
Segment descriptor? 
System indicator 
Bit (Meaning When Set 
Subsystem identification follows system 
identification 
Reserved 
MVS/XA 
VS2 
VS1 
Record type (Hexadecimal! values are 0-255) 
SVC 11 Time since midnight, in hundredths of a second, 
or record was presented to SMF? 
SVC 83 : 
SVC 11 Date record was presented to SMF, in the form 
or | OOYYDDDF, where F is the sign2 
SVC 83 
JUMRCPUID System identification (taken from SID 
or parameter) 
SMCASID \ 
1 . | OS ee. 
These two fields (total of four bytes) form the record descriptor word (RDW). The first two 
bytes must contain the logical record length including the RDW. The second two bytes are 
used for variable block spanned records. If the record is not spanned, set these two bytes to 
hexadecimal zeroes. These fields must be filled in before writing the record to the SMF data 
set. 
In record types 2 and 3, these fields indicate the time and date that the record was moved to 
the dump data set. : 
Notes: 
1. Because the record formats include the RDW, it is not necessary to add four bytes to the 
offset listed in the record; however, depending on the access method used to read the record 
from the SMF data set, these fields might not be present in your SMF record. In this case, 
you might have to subtract four bytes from the offsets listed in your record. | 
2. For MVS/XA, both the MVS/XA bit and the VS/2 bit are set. 
Figure 6-1. Standard SMF Record Header for Records without Subtypes 
o~ 
{ 7 
‘ut / 
MY 
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(The “Name” field in all 
of the SMF records 
contains the symbolic 
addresses defined by the 
IFASMFR macro 
instruction.) 

























SVC 83 





System indicator 
Bit Meaning When Set 


internal 





0 Subsystem identification follows system 
identification 

1 Subtypes utilized 

2-4 Reserved 

5 MVS/XA 

6 VS2 

7 VS1 


internal 
binary SVC 11 
ae 83 
packed = 11 
eve 83 

EBCDIC JUMRCPUID 
or 

SMCASID 


EBCDIC internal 








Record type (Hexadecimal values are 0-255) 


Time since midnight, in hundredths of a second, 
record was presented to SMF2 






Date record was presented to SMF, in the form 
OOYYDDDF, where F is the sign? 







System identification (taken from SID 
parameter) 







Subsystem identification. This field is a four 
byte character value set by the SUBSYS=option | 
specified in the SMF macros. 


Record subtype (Hexadecimal values are 0-255) 


1 These two fields (total of four bytes) form the record descriptor word (RDW). The first two 
bytes must contain the logical record length including the RDW. The second two bytes are 
used for variable block spanned records. If the record is not spanned, set these two bytes to 
hexadecimal zeroes. These fields must be filled in before writing the record to the SMF data 
set. 





2 In record types 2 and 3, these fields indicate the time and date that the record was moved to 
the dump data set. 


3 See Chapter 3 Part II — SMF Functions for a description of subtype selectivity. 


Notes: 


| 1. Because the record formats include the RDW, it is not necessary to add four bytes to the 

| offset listed in the record; however, depending on the access method used to read the record 
| from the SMF data set, these fields might not be present in your SMF record. In this case, 

| you might have to subtract four bytes from the offsets listed in your record. 


2. For MVS/XA, both the MVS/XA bit and the VS/2 bit are set. 
Figure 6-2. Standard SMF Header for Records with Subtypes 
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Summary of SMF Records 


Figure 6-3 summarizes the SMF records according to the type of data they contain, 
such as VSAM or JES2 data, and the events (or status indicators) that cause SMF 
to generate the records. To write any SMF-formatted records (except record types 
2,3 and 7) to the SMF data set, you must specify the ACTIVE parameter. To 
write record type 17 for temporary data sets, you must specify REC(ALL). Figure 
6-2 also indicates the method of entry to the SMF SVC 83 routine. The method of 
entry determines which user exit routine, either IEFU83 or IEFU84, receives 
control before control is returned to the caller of the SVC 83 routine. A branch 
entry, indicated by BR, results in the IEFU84 exit receiving control whereas an 
SVC call, indicated by SVC, results in the IEFU83 exit receiving control. 


Many current SMF records contain variable sections. The user of these records 
should be aware that the record pointers must be updated by the length of each 
variable section of the record when the record data is being manipulated. Failure 
to do the address calculation will result in writing over valid data in previously 
processed sections. Other SMF records such as record type 23, 30, 32, and 90, 
contain offsets that point directly from the record header to the data section. 


Note: Ina loosely-coupled multiprocessing environment (such as JES2 shared spool or 
JES3), it is possible for the job START/LOGON time to be greater than the STOP/ 
LOGOFF time because the installation does not synchronize the CPU clocks. The dif- 
ference occurs when the START/LOGON time is initialized on processor (A) and the 
job is then executed on processor (B). The STOP/LOGOFF time is recorded from 
processor (B). 


For a summary of all of the fields in the SMF records, see “Chapter 7: Field- 
to-Record Cross-Reference.” 
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a 











pita ni 











Entry | 
Type 


Record 
Type 


Category 
Event or Status 
















IPL 

Day Dat Devices online at IPL SVC 

ay Data 
: 22, | BR! | 

MODIFY TCAM command issued 31 SVC 
SET, HALT and SWITCH command BR2 
information 

Data in Access and unaccess of data in 4 SVC 

Virtual (DIV)} virtual object 

svc! 


V 
svcl 
VC 


©) 


22 


” 


” 
< 
\?) 


NO 


WO NO 


CPU, storage, or channel path 
moved online or offline 
Machine Devices brought online 
Data 
Devices recovered at allocation 
Devices taken offline 


Space available on DASD volumes: 
at IPL, after HALT EOD or SWITCH 
SMF command, when demounted 


22 svcl 





7) 
< 
‘@) 


Auxiliary 
Storage 
Data 





V 
SVC 


Tape volume demounted 


VSAM data space defined, extended, 
or deleted 


Yn 
O 








W 
© 


Step processing 


W 
BS 


Job processing 





io) 
oO! 


V 


” 


2) 






Processing 










SYSOUT processin 
vee 26 | svc 
20 | BR 
Data set dynamically unallocated, 0 | BR 
concatenated or deconcatenated 
Normal or abnormal termination 30 | BR 
TSO normal or abnormal termination 32 | BR | 
Data Set opened for 
Dataset | inNPUT, or RDBACK svc 
Non-VSAM closed or 
Data Set processed | Data set opened for : 
by EOV OUTPUT, UPDAT, SVC 


Activity 


Data INOUT, or OUTIN 





17 
SVC 
Integrated Catalog Facility Exported 36 SVC 
Integrated Catalog Facility component SVC 
_Or cluster created, updated or deleted. 
VSAM Integrated Catalog Facility entry SVC 
Data Set defined ; 
Activity Component or cluster opened SVC 


Set 


Oo Oo 





Entry defined 63 
Integrated Catalog Facility entry SVC 
deleted 
( = Tonty when written after an IPL by IEEMB823. All other records are written by means of an 
SVC call. 


ze xcept when written fora SETDOMN command by IEE8603D or fora HALT EOD command 
by 1EE70110. These records are written by means of an SVC call. 


Figure 6-3. Summary of SMF Records (Part 1 of 3) 
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Category 


Event or Status 
of Data 









[Job processed by JESSMDS 


Data user signed on 
user signed off 
on with invalid password 
transmission 

Network Application reporting 


Data Network Performance Monitor 
Network Logical Data Manager 


Data Transmission 
management 
Dats 


Sort/merge statistics 





Figure 6-3. Summary of SMF Records (Part 2 of 3) 
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1 Integrated Catalog Facility entry 
altered 
| Entry deleted 
Entry renamed 
JES2 Output Writer 
JES2 Job Purge 
Export of catalog 
S JES2 or $E SYS command issued 
$P JES2 command issued 
$S LNEn or $E LNEn command 
issued, or remote user signed on 
user signed off 
_$E LNEn command issued, or 
JES2 remote user attempted to sign on 
Data with invalid password 


fo) 


Record 


Z 
8 


67 


0) 


43 


AS 
~~ 


57 


26 


47 


57 
37 
38 
39 
7 


Z2|> 
>I 


wid 
0) 


Entry 


nm] n 
lak 
O, O78 





“Svc 


SVC 
SVC 


svc 
SVC 


SVC 


” 
< 
O 


” 
; 
QO 


” 
< 
O 


SVC 


Vv 
svc 


n1n 
< 
Q1O 


nln 
< 
OTM 


V 
SVC 


n1n 
< 
QO1O 


V 


” 
< 
O 


SVC 


n” 
< 
© 


V 


“” 
O 


SVC 


” 
< 
O 


SVC 
SVC 
SVC 


N/A 


~~ 


z\iz2z = 
~j™~ 
Z\i> > 


SVC 















Category 

a 
nee 
Initialization Record 81 


ACF/VTAM 
Tuning Data 


Record Entry 
Type Type 


Ss 
Ss 
S 
Ss 
S 
S 

















ACF/VTAM tuning statistics 


CPU Activity | 
Paging Activity 





1 
SVC 


Workload Activity 
Channel Activity 


S 


sve 
sve 
Tsve_| 
sve 


Page/Swap Data Set Activity 
Record 


Trace Activity Record 
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Figure 6-3. Summary of SMF Records (Part 3 of 3) 
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Record Type 0 (00) — IPL 


Record type 0 is written by IEEMB823 after every IPL of the system. It includes 
the virtual and real storage sizes and some of the SMF options in effect. Its length is 
35 bytes: 


The format is: 
ora eas [Fone 


SMFOLEN internal 


_ 2 {bi 
2 ei 
ALLE 7 


Description 


Record length 
Segment descriptor 


System indicator 


Bit Meaning When Set 
0-4 Reserved 


MVS/XA 
VS2 
VS1 





| 6 | 5 | SMFORTY binary | internal Record type 


SMFOTME binary | SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
A SMFODTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDODF where F is the sign 
| 14 | & | sSmMFosin | 4 | EBCDIC System identification (taken from SID parameter) 
SMFOJWT binary | SMCAJWT Limit, in minutes, of continuous wait time for the job 
(taken from JWT parameter) 
|22 | 16 | sMFoBUF | 4 | binary | SMCANMBF x 4096 | Number of bytes in SMF buffer_ 
| 26 | 1A | smFovst | 4 | binary | (CVTMZ00+1)/1024 | Number of 1K bytes in virtual storage 


' SMFOOPT binary | SMCAOPT SMF options 

Bit Meaning When Set 

0 Reserved 

1 Reserved 

2 Reserved 

3 Data set accounting. Record types (see Note 1) 
selected 
Volume accounting. Record types 10 or 69 
selected 
Reserved 
Type 17 records will be written for temporary 
data sets (REC(ALL)) 

7 Reserved 


} 31 | 1F | SMFORST | 4 | binary | CVTRLSTG Number of 1K bytes in real storage 


Notes: 
1. This bit is set on when one of the following record types is 
selected: 14, 15, 17, 18, 62, 63, 64, 67, or 68. 
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Record Type 2 (02) — Dump Header 


Record type 2 is written directly to the dump data set by IFASMFDP, the SMF 
dump program. This record consists of only the standard SMF record header. It 
indicates the beginning of a dump of the SMF data set from a direct access device 
usually to a tape. Its length is 18 bytes. 


The format is: 


internal Record length 
internal Segment descriptor 


foe 

a ‘eo 

re IF ASMFDP System indicator 
fee 








Bit Meaning When Set 
0-4 Reserved 

5 MVS/XA 

: VS2 














VS1 
SMF2RTY internal Record type 
SMF2TME binary | SVC 11 (Set by Time, in hundredths of a second, record was moved to the 
IF ASMF DP) dump data set 


packed SVC 11 (Set by Date record was moved to the dump data set, in the forin 
| 1FASMFDP) OOY YDDDF where F is the sign 


EBCDIC| SMCASID System identification (taken from SID neat 


SMF2SID 
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SMF3TME binary SVC 11 (Set by Time, in hundredths of a second, record was moved to the 
1F ASMFDP) dump data set 











Record Type 3 (03) — Dump Trailer 


Record type 3 is written directly to the dump data set by IFASMFDP, the SMF 
dump program. This record consists of only the standard SMF record header. It 
marks the end of a dump of the SMF data set from a direct access device usually 
to a tape. Its length is 18 bytes. 


The format is: 


ae wen [ Format sewse [Omron 
| binary | internal = Segment descriptor 
6 VS2 


oo F3SFLG poe een SVC ae System indicator 
7 VS$1 


Bit Meaning When Set 
SMF3RTY | 1 | binary | internal  —_{ Record type 















0-4 Reserved 
5 MVS/XA 











SMF3DTE packed | SVC 11 (Set by Date record was moved to the dump data set, in the form 
IF ASMFDP) OOY YDDDF where F is the sign 


| € | SMF3sID | 4 | EBCDIC|SMCASID System identification (taken from SID parameter) 
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Record Type 4 (04) — Step Termination 


Record type 4 is constructed by IEFTB722 and written by IEFTB721 at the 
normal or abnormal termination of a job step for a background job, or when a job 
step is flushed during or after job initiation. It is not written for a job step that 
follows a CANCEL operator command. Its length is 202 bytes plus (1) eight bytes 
for each device entry and (2) the length of the step accounting fields. 


This record identifies the job step by the job log identification, step name, 
number of the step within the job, user identification, program name and perform- 
ance group number. If accounting numbers (which can be alphameric) were 
specified in the EXEC statement, they are included. 


This record also contains operating information such as the job step start and 
end times, step CPU time, step service, step termination status, number of records 
in DD DATA and DD* data sets for the step, device allocation start time, problem 
program start time, and storage protect key. It contains the number of page-ins, 
page-outs, swap-ins, and swap-outs for both VIO and non-VIO data sets. 


Record type 4 has an entry for each non-spooled data set that was defined by a 
DD statement. Each entry lists the device class, unit type, channel address, unit 
address, and EXCP count for the data set. 


Notes: — 
1. Data sets are usually recorded in the order of the step DD statements; they are 
not identified by name. (A user-written IEFUJV exit routine can record this 


order as each statement is validated.) Dynamic allocation or deallocation can 
affect the order. | 


2. For data sets that are dynamically unallocated, the data set entry information is 
in record type 40 — not in record type 4. 


3. For more information on EXCP count and CPU time, see Chapters 8 and 9, 
| respectively. 
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foo 


‘ 


eo 

















The format is: 


Rome [tone [Forme 


SMF4LEN binary 


Record length 


| 2 | binary | internal Segment descriptor 


System indicator 
Bit Meaning When Set 
0-4 Reserved 


5 MVS/XA 
6 VS2 
7 VS1 


Record type 


SMF4FLG 7 binary | SVC 83 


‘SMF4TME binary | SVC 83 Time, in hundredths of a second, record is passed to the 
SMF writer. This is the time the step terminated. 


Date in the form OOYYDDDF, where F is the sign, record is 
passed to the SMF writer. This is the date the step 
terminated. 


EBCDIC] JMRCPUID System identification (taken from SID parameter) 
SMFAIBN E8cDIC| JMRIO8 


SMF4RST binary | JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job? 





” 





A SMF4DTE packed | SVC 83 






awk 


A 


form OOYYDDDF where F is the sign? 


BCDIC}| JMRUSEID User identification (taken from common exit parameter 
area) 


| 4 | binary | LCTSNUMB Step number (first step=1, etc.) 


binary | JCTJMRSS (Set by} Time, in hundredths of a second, initiator selected this step 
IEFSMFIE) 


JMREDATE Date reader recognized the JOB card for this job, in the 
E 


SMF4UIF 


B MF4SIT 


MF4STID JCTSSD (Set by | Date initiator selected this step, in the form OOYYDDOF 


IEFSMFIE) where F is the sign 


SMF4NCI 
sets read by the reader for the step 


37 | SMF4SCC binary | TCBCMPC Step completion code: 

X‘Occc’ indicates system ABEND in the job step where ccc 

is the system ABEND code. (See System Codes.) 

X‘8cce’ indicates user ABEND in the job step where ccc 

is the user ABEND code. 

X‘nnnn’ indicates normal completion where nnnn is the 

contents of the two low-order bytes in register 15 at 

termination. 

X‘0000’ indicates either 

(1) the job step was flushed (not executed) because of an 
error during allocation or in a preceding job step, or 

(2) normal job completion with a return code of 0. 

Use this field in conjunction with the step termination 

indicator field (offset 87). 


1The job name and the time and date that the reader recognized the JOB card for this job constitute the job (Continued) 
log identification. 


” ee) 
= 
n 
4 
2 


SCTSMF Number of card-image records in DD DATA and DD* data 


Ni 
> 
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39 | SMF4PRTY 1 binary SCTSDPTY | Address space dispatching priority (taken from DPRTY= 
parameter on EXEC card or the APG value in CVTAPG)2. 
58 13A | SMF4PGMN EBCDIC |SCTPGMNM 
card). If a backward reference was used (SCTSTYPE equals 
X‘80'), then this field containd *.DD. 


SMF4STMN EBCDIC |SCTSNAME Step name (taken from name on EXEC card) 


74 14A | SMF4RSV5 binary Reserved. Note that SMF4RSHO, formerly a two-byte 
field at this offset, has been increased to four bytes and 
_moved to offset 82. 
2 TCTHWM/1024 
78 | 4E | SMF4HOST 2 binary |TCTLWM/1024 
this field equals the amount of contiguous real storage 
that was used. See offsets 82 and 102.3 
gram. If the region requested was greater than 16 megabytes, 
the region established resides above 16 megabytes, and this 


82 | 52 | SMF4RSHO binary TCTRSZ*2 Region size established, in 1K units taken from the 
field will contain a minimum value of 32 megabytes. 


Ez) 
~ 






Program name (taken from PGM= parameter on EXEC 












2 











76 | 4C | SMF4SYST Largest amount of storage used from top of private area, 
in 1K units. This storage area includes the LSOA and SWA 
(subpools 229, 230, 236, 237 and 253-255). If 
ADDRSPC=REAL is specified, this field equals the amount | 
of storage used that was not from the contiguous real 


storage reserved for the program. See offsets 82 and 102.3 












Largest amount of storage used from bottom of private 
area, in 1K units. This storage area includes subpools 
0-127, 251 and 252. |f ADDRSPC=REAL is specified, 













the amount of contiguous real storage reserved for the pro- 








REGIONE= parameter in the JCL, and rounded up to a 4K 
SMF4SPK 1 binary |TCBPKF — Storage protect key, in the form xxxx0000 where xxxx is 
the key 
4 


boundary. If ADDRSPC=REAL is specified, this field equals 
87 | 57 | SMF4STI Step termination indicator 






Meaning When Set 
0-1 Reserved 

2 Canceled by exit |EFUJI4 

3 Canceled by exit 1EFUSI4 

4 Canceled by exit IEFACTRT4 
5 

6 
























JCTJMRCL 
JCTJMRCL 
JCTJMRCL 
JCTSTEPR 

TCBFA 


Step is to be restarted 

If 0, normal completion. If 1, ABEND. If step 
completion code (offset 55) equals 0322 or 0522, 
IEFUTL caused ABEND. If step completion code 
equals 0722, |IEFUSO caused ABEND. 

If O, normal completion. If 1, step was flushed. 














TCTHWM 7 





SMF4AST TCTAST (Set by Device allocation start time, in hundredths of a second 


5A 
1EFBB401) 


(Continued) 


21 the dispatching priority falls within the APG range, the actual execution dispatching priority 


will be assigned based on the Installation Performance Specification (IPS). If the dispatching 
priority is controlled via the IPS, it may periodically change based upon user characteristics. 

If the dispatching priority is not in the APG range, the value in the field (SMF4PRTY) will be the 
actual execution dispatching priority. For more information see /nitialization and Tuning. 


Sif storage was not allcoated (job step was flushed), these fields equal zero. 


4 Job steps canceled by IEFUJI and IEFUS! will not be executed; therefore bit 7 will also be on. Job steps 
canceled by I|EFACTRT will cause subsequent job steps to be canceled; record type 4 is not produced for 
subsequent job steps. 
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Torts [ _wone [own] rome] sowe [tn 
SMF4PPST binary | TCTPPST (Set by Problem program start time, in hundredths of a second 
1EFAB820) | 


res[ez|swranve [1 [bey [Si ewes SSCS 


i SMF4SRBT aa SCTSRBT Step CPU time under SRBs, in hundredths of a second. 
lf 1, storage is real. 


This field includes the CPU time for various supervisory 
routines that are dispatched via SRBs: locking routines, 
page resolution, swap control, cross-memory communica- 
tions (WAIT, POST, I/O POST), and TQE scheduling. 
binary Record indicator 
Bit | Meaning When Set 
8-15 Reserved 
SMF4RLCT binary Offset from the beginning of the record (SMF4FLG) header 
to the relocate section 
6A | SMF4LENN binary Length of device entry portion of record. Calculated as: 
(8 times the number of devices) + 2 
For each device assigned to each non-spooled data set, there is an eight-byte entry with the following format: q 
SMF4DEVC UCBTBYT3 
SMF4UTYP UCBTBYT4 


0-4 Reserved 9 
5 Device data not recorded 
SMF4CUAD UBCHAN : 
SMF4EXCP TCTDCTR 



















6 EXCP count might be wrong.© 
7 lf O, storage is virtual. 






Device class 















Unit type 








Device number. 


EXCP count (see offset 102). 






















SMF4LNTH 
SMF4SETM 





internal 
ACTJTIME 


Length of accounting section, excluding this field 


Step CPU time under TCBs, in hundredths of a second. 
This field includes the CPU time for all tasks that are 
dispatched via TCBs below the level of RCT.° 


Number of accounting fields 


















| SMF4NAF internal 


Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) followed 
by the field (EBCDIC). A zero indicates an omitted field. 





binary | OUXBPIN Number of non-V1O, non-swap page-ins for this step. This 
field includes page-ins required through page faults, specific 
page requests, and page fixes. It does not include page 

reclaims, page-ins for VIO data sets, pages that are swanped 


in, and page-ins for the common area. 









(Continued) 
31f storage was not allocated (job step was flushed), these fields equal zero. 


SCPU time is not expected to be constant between different runs of the same job step. For more information on 
CPU time, see Chapter 9. 


61f a GETMAIN for expanding the TCTIOT (the data area where EXCPs are maintained) fails, only the existing 
data sets are counted. If the functional recovery routine is entered, EXCP counting for the step is discontinued 
and no device entries are produced. !f ADDRSPC=REAL is specified, the EXCP does not include PCls. For more 
information on EXCP count, see Chapter 8. 

TEntries for DD*, DD DATA, DD DUMMY and spooled data sets are zero. (A DD DUMMY entry occurs when a 
forward reference to a DD statement with that DD name, but no matching DD statement is found, or when DD 
DUMMY is specified.) Entries for virtual |/O data sets are zero for class and type, and X‘7FFF’ for device number. 

. When the high order bit is on in the device number field, a virtual device is indicated. 


8The displacement of this field depends upon the size of the accounting fields and the number of devices. Offset 
104 contains the displacement for this field. 


2 When the TIOT size is greater than 32K (more than 1635 DD statements), device data is not collected for the 
type 4 record. The data is available in the type 30 record. 
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[orteets [Name [uengthl Format] Source | ——~S~S~é tio 


Relocate Section: (Continued) 


SMF4PGOT | OUXBPOUT Number of non-VIO, non-swap page-outs for this step. 

. This field includes page-outs required through specific page 
requests as well as those pages stolen by the paging | 
supervisor as a result of infrequent use. It does not include 
page-outs for VIO data sets, pages that are swapped out, 


and page-outs for the common area. 


+8 binary | OUXBSWCT Number of address space swap sequences. (A swap sequence 
| consists of an address space swap-out and swap-in.) 


lime OUXBSPIN Number of pages swapped in. This field includes: LSQA, 
+16 


fixed pages, and those pages that the real storage manager 
col a 


determined to be active when the address space was 
SMF4VPI binary OUXBVAMI 



















swapped in. It does not include page reclaims nor pages 
found in storage during the swap-in process (such as pages 
brought in via SRB’‘s started after completion of swap-in 
Stage 1 processing). 






Number of pages swapped out. This field includes: LSQA, 
private area fixed pages, and private area non-fixed changed 
pages. 


Number of VIO page-ins for this step. This field includes 
page-ins resulting from page faults or specific page requests © 
ona VIO window. It does not include VIO swap-ins or 

page-ins for the common area. 





| +20 











Number of VIO page-outs for this step. This field includes 
page-outs resulting from specific page requests on a VIO 

- window, as well as those pages stolen by the paging 
supervisor as a result of infrequent use. It does not include 
VIO swap-outs or page-outs for the common area. 


+24 SMF4VPO binary OUXBVAMO 


SMF4SST 


SMF4ACT ¥ 
“pe OUCBNPG 
SMF4TRAN “pe 


OUXBJBS + Step service, in service units. This field is calculated as: 
‘OUXBTRS total iob service minus the accumulated job service prior to. 
this step‘s initialization.2 | 


binary 


OUXBJBT + Step transaction active time, in 1024-microsecond units. 

OUXBTRT Calculated as: total job transaction active time minus the 
accumulated transaction active time prior to this step’s 
initialization. 


+ 
8) 
N) 








Step performance group number (taken from PERFORM= 
parameter on JOB or EX EC card or the RESET operator 
command).? 













OUXBJBR + 
OUXBTRR 


Step transaction residency time, in 1024-microseeond 
units. That is the amount of time the transaction was in 
real storage. 







8 
a a a ee 
o. 
Fe 
qi 


SMF4RECL 
SMF4RCLM 


Number of private area reclaims for this step. | 





Number of VIO reclaims for this step — 


Number of common area page-ins for this step (LPA + CSA) 


5 
SMF4CRCL 
SMF4PGST 


/'SMF4PSEC epee OUCBPSS 
ean 


SMF4LPAI 4 {binary OUXBLPAI 







Number of common area reclaims for this step (LPA + CSA) 







Number of pages stolen from the storage for this step 


Number of page seconds for this step, in. page millisecond 
units. Calculated as: the number of pages used by this step 
times the execution time it held that number of pages. 


Number of link pack area page-ins for the step 


+ 
0) 
NO 


ry 
J 
© 





_ |SMF4LPAR | 4 = [binary | OUXBLPAH ‘Number of link pack area reclaims for the step | 
+78 SMF4CPUS binary | OUXBJCPU + PU service, i ice units? 
[faerie [+ fer [aoe 
SMF4I0OCS binary | OUXBJIOC + Step I/O service, in service units? 
OUXBTIOC . 
+86 binary OUXBJMSO + . Step main storage service, in service units? 
‘OUXBTMSO | | | 
fase | OUXBTSRB Step SRB service, in service units 


9 For more information on service, transaction active time, and performance group number, 


— see Initialization and Tuning. 
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eel 














( Oo Record Type 5 (05) — Job Termination 


Record type 5 is constructed by IEFTB722 and written by IEFTB721 at the 
normal or abnormal termination of a background job. Its length is 137 bytes plus 
the length of the job accounting fields. (The maximum length of this record is 
281 bytes.) 


This record identifies the job by job log identification, user identification, 
priority, input class, and programmer's name. If accounting numbers (which can be 
alphameric) were specified in the JOB statement, they are included. 


This record also contains operating information such as the job start and end times, 
number of steps in the job, number of records in DD DATA and DD* data sets for 
the job, job termination status, device class, unit type, storage protect key, job 
service and job CPU time. (The job CPU time equals the sum of the job step times.) 


Note: For more information on EXCP count and CPU time, see Chapters 8 and 9, 
respectively. 


The format is: 


[Format | Souree {| seription 
ro [o | SMFSLEN Record length 
[2 [2 [SMFssec_ Segment descriptor 


Eee 
| 2 [bi 
SMF5FLG binary | SVC 83 System indicator | 
Bit Meaning When Set 
0-4 Reserved 
| 5 MVS/XA 
6 VS2 
VS1 


rs [5 [awrenry 
SMF5TME binary | SVC 83 Time, in hundredths of a second, record is passed to the 
SMF writer. This is the time the job terminated. 


au SMF5DTE packed | SVC 83 Date, in the form OOY YDDDF, where F is the sign, record is 


passed to the SMF writer. This is the date the job 
|14 | E | SMFS5SID 


terminated. 
fra [12 | swFsi6N ; 
baat a SMF5RST 


| 8 | EBCDIC] IMRVOB 
packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign? 


[ots [ Rane [te 



































binary JMRENTRY Time, in hundredths of a second, reader recognized the JOB 
card for this job? 
SMFS5UIF EBCDIC | JMRUSEID User identification (taken from common exit parameter 
| area) 
SMF5NST JMRSTEP Number of steps in the job 
43 SMF5JIT binary JCTJMRJT (Set by | Time, in hundredths of a second, initiator selected the job 
1EFSMFIE) 
47 SMF5JID packed | JCTJMRJD (Set by | Date initiator selected the job, in the form OOY YDDDF 
IEFSMFIE) where F is the sign 
SMF5NCI binary | JMRJOBIN Number of card-image records in DD DATA and DD* data 
sets read by the reader for the job . 
1The job name and the time and date that the reader recognized the JOB card for this job constitute the | (Continued) 
job log identification. 
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user-assigned priority of 0 to 13, but if the job fails 
3A | SMF5RSTT | binary | JMRDRSTP Time, in hundredths of a second, reader recognized the end 
of the job.4 
fer [as [swrccwer [1 [bey | sd ewe 
| 73 | 49 SMF5RDCL Boa JMRROR Reader device class. (This field is not filled in for jobs 
submitted via an internal reader.) 


37 | SMF5JCC ee 9 | TCBCMPC Job completion code: : 
X‘Occe’ indicates system ABEND in the last job step where 
ccc is the system ABEND code (see System Codes). 
X‘8ccc’ indicates user ABEND in the last job step where ccc 
is the user ABEND code. | 
X‘nnnn’ indicates normal completion where nnnn is the 
contents of the two low-order bytes j in register 15 at 
termination. 
X‘0000' indicates normal job completion with a return 
code of 0.2 
Use this field in conjunction with the job termination 
indicator field (offset 66). 
while being scheduled, this field equals 14 (taken from 

SMF5RSTD | Packed JMRDRSTP + 4 Date reader recognized the end of the job, in the form 

OOY YDDDF where F is the sign:4 

44 |SMF5TRAN binary | OUXBJBR + Job transaction residency time, in 1024-microsecond units. 

OUXBTRR That is the total amount of time the transaction was in 
real storage. 9 
74 144 | SMF5RUTY binary | JMRRDR Reader unit type. (This field is not filled in for jobs 

submitted via an internal reader.) 


57 | 39 | SMF5JPTY binary | JCTJPRTY Job selection priaqrity. This field normally equals the 
the PRTY parameter on the JOB card).3 
SMF5JBTI | binary Job termination indicator 
Bit Meaning When Set | 
Reserved 
Canceled by exit [EFUJV 
JCTJIMRCL Canceled by exit [EFUJI 
| JCTJMRCL Canceled by exit IEFUSI 
JCTJIMRCL Canceled by exit IEFACTRT (step exit only) ——. 
| Reserved YY 
If 0, normal completion. If 1, ABEND. Ne 
Reserved 
[v2 [ae [swescxne | [emey [Reems 
(Continued) 





2 When a step in a multi-step job terminates abnormally, the subsequent steps, whether executed or flushed, do 
not propagate the step abend code for processing by this record. The code appears in the step termination 
record (type 4). In this case, the field, offset 55, can contain X‘nnnn’ or X‘0000': the job termination 
indicator (offset 65, bit 6) is set to 1 if an abend occurred in the job. 

Sif no value is specified for the PRT Y parameter on the JOB card, this field contains: 

e For JES3, the default priority specified on the JES3 STANDARDS initialization card 
e For JES2, a zero. 
Note that JES2 does not use the priority value reported in this field. 


4 the job that is terminating is ‘JES2’ or ‘JES3’ then this field might be set to zero, 


SFor more information on service, transaction active time, and performance group number, see Initialization and Tuning. 
Note that the service, active time, and residency time may have been accumulated under different performance group 
numbers. 
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r 


ea 


i 


SMFSJICL 


SMF5SRBT 3 


SMFS5TJS 
SMF5TTAT 


SMF5RV2 


5C | SMFS5PGNO 


SMF5RV3 
SMF5TLEN 
SMF5PRGN 


75 | SMF5JCPU 


78 | SMF5ACTE 


8 
79 | SMF5JSAF | variable |EBCDIC 


Relocate Section: 





~“ 


BS 
a] aleiela] se} est 8) ale 
















ee 
EBCDIC] JCTJICSMF Job input class (taken from JOB card; default equals ‘A’) 
binary | TCBPKF Storage protect key, in the form xxxx0000 where xxxx 
is the key | 
binary | SCTSRBT Job CPU time under SRBs, in hundredths of a second. This 
field includes the CPU time for various supervisory routines 
that are dispatched via SRBs: locking routines, page 
resolution, swap control, cross-memory communications 
(WAIT, POST, I/O POST), and TQE scheduling. § 
binary | OUXBJBS + Job service, in service units ? 
OUXBTRS 
binary |OUXBJBT + Job transaction active time, in 1024-microsecond units 5 
OUXBTRT | 
binary |OUCBNPG Performance group number of last step (taken from 
PERFORM= parameter on JOB or EXEC card or the result 
of a RESET or SET IPS command)® 
binary | ACTLEN (in JCT) Length of rest of the fixed portion of the record 
binary |ACTJTIME (in JCT) | Job CPU time under TCBs, in hundredths of a second. 
This field includes the CPU time for all tasks that are 


~J 


=10 00 ~ a] ~ 
a rs) oa 


20 
3 





dispatched via TCBs below the level of RcT.6 


bi nary | ACTJNFLD (in JCT) | Number of accounting fields 


20 





Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) followed 
by the field (EBCDIC). A zero indicates an omitted field. 








BEE 


JOB statement 


OUXBJCPU + 
OUXBTCPU 


binary | OUXBJIOC + Job 1/O service, in service units” 
OUXBTIOC 

binary |OUXBJMSO + Job main storage service, in service units? 
OUXBTMSO 

binary |OUXBJSRB + Job SRB service, in service units 
OUXBTSRB 








SMF5CPUS Job CPU service, in service units” 









binary 


ie SMF5IOCS 


| 


SFor more information on service, transaction active time, and performance group number, see /nitiafization and Tuning. 
Note that the service, active time, and residency time may have been accumulated under different performance group 
numbers. 


6CPU time may not be constant between different runs of the same job. For more information on CPU time, see 
Chapter 9. 
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Record Type 6 (06) — JES2 Output Writer 


Record type 6 is written by HASPPRPU (JES2 writer). The JES2 writer writes this 
record when processing is completed for a job output element (JOE), or when there 
is a change in certain information (indicated by “*’’) describing SYSOUT data sets 


‘processed in the same JOE. If a printer is running under the control of a functional 


subsystem (FSS), record type 6 is written for each data set printed on that printer. 
This record is also written for spin data sets. If the JES2 writer is used, the record 
length is 94 bytes plus 36 bytes for the 3800 (non-impact) printing subsystem sec- 
tion and 14 bytes for the routing section. (Note: If an external writer or user- 
supplied writer is used, the length is 88 bytes. See “Record Type 6 (06) — External 
Writer” for more information.) 


This record identifies the output writer by SYSOUT class and form number, and 
identifies the job according to job log identification, JES2-assigned job number, 
and user identification. It also contains information on the output writer activity 
such as the number of logical records processed, number of data sets processed, 
writer start and end times, input/output status indicators, data set control indica- 
tors, and JES2 logical output device name. 


This record also provides information on the activity of the 3800 (non-impact) 
printing subsystem. For additional information on the 3800 printer, see the JBM 
3800 Printing Subsystem Programmer’s Guide. 


The format is: 


System indicator 


Bit Meaning When Set 
0-4 Reserved 

5 MVS/XA 

6 VS2 

7 Reserved 
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26 1A SMF6RST binary JCTRDRON Time, in hundredths of a second, reader recognized the 
JOB card for this job! 
30 SMF6RSD packed JCTRDTON Date reader recognized the JOB card for this job in the 
form OOYYDDDF where F is the sign? 
34 22 SMF6UIF EBCDIC | JCTUSEID User identification (taken from common exit parameter 
area) 
42 2A SMF6O0WC EBCDIC | JOECURCL *SYSOUT class. (This field is blank for non-SYSOUT 
data sets.) 
43 2B SMF6WST 4 binary PITMEON (in Start time, in hundredths of a second, of print/punch 
PPPWORK)2 processor working on the data in this record 
47 2F SMF6WSD 4 packed PTIMEON +4 Start date of print/punch processor working on the data 
(in PPPWORK)2 in this record, in the form OOYYDDDF where F is the 
sign 
33 | SMF6NLR 4 binary PPLNCDCT Number of logical! records written by the writer, by form 
(in PPPWORK)2 number and class. (This field includes JOBLOG informa- 
tion and data set copies.) 
37 SMFG6IOE binary PPFLAG (in {/O status indicators 
2 
PPPWORK) Bit | Meaning When Set 
0-4 Reserved 
*5 Data buffer read error 
6 Reserved 
<7 Control! buffer read error 
38 SMF6NDS binary PPJNDS (in Number of data sets processed by the writer and included 
PPPWORK)2 in this record. If multiple copies are produced, each copy 
is not counted. (This field includes JOBLOG information. ) 
57 39 SMF6FMN EBCDIC | DCTFORMS Output form number. If the source field contains four or 
fewer characters, SMF6FMN will be set. Otherwise, this 
field contains blanks and the contents of the source field 
appears only in SMF6EFMN, described under the JES2 
Routing Section later in this record. 
SMF6PAD1 1 binary UCBTYP Section indicator 
Bit Meaning When Set 
0 3800 printing subsystem section present 
1 Routing section present 
2-7 Reserved 
Te2 | se | swroses Subsystem identification — X°0002 signifies JES2 
64 SMF6LN1 2 binary internal Length of rest of record, including this field, but not 
including any additional sections indicated by the 
SMF6PAD1 field 





'The job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 
PPPWORK is the print/punch processor work area. 


* A change in this field will cause a new record type 6 to be written. 
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ds 


PSMFDCI (in 
PPPWORK)1 
4-7 A value of X‘01' indicates the first level of the 
restructured SMF type 6 record for JES2 Version 


1 binary internal 
2 Release 1.5. 
| 8 





42 SMF6DCI binary Data set control indicators 













Meaning When Set 

0 Reserved 

1 Record represents spin data sets 

<2 Operator terminated this data group 

*3 Operator interrupted this data group 

*4 Operator restarted this data group 

*5 Record represents continuation of interrupted 
data group 

*6 Operator overrode programmed carriage contro! 

(printer only) 

Punch output was interpreted (3525 only) 


















Record level indicator 2 






Bit Meaning When Set 
0-3 Reserved 









& 
f& 


aa 


SMF6JNM 


SMF6OUT 
SMF6FCB 
SMF6UCS 


67 43 SMF6INDC 


SMF6RTE binary DCTNO Output route code4# 


PPPWORK is the print/punch processor work area. 
Each time the record is changed, the value of this field is increased by 1. 
For a printer controlled by JES2, the count is updated: 


00 


~J 


84 
88 


88 
NO 


C 





1 


@ On askip to any channel instruction if LINECT=0 is specified on the JOBPARM JECL statement, in the accounting field of the 
JOB statement, on the OUTPUT JECL statement, or on the OUTPUT JCL statement 


@ After the number of lines specified in LINECT or a skip to any channel instruction is reached 


For a printer controlled by an FSS, the count is affected by one or more of the following: 
e APAGEDEF statement 
e A FORMDEF statement 


@ The presence of page mode data 


Athis field is defined as follows: X‘0100’ indicates local routine; X‘nnrr’ (where nn is the node number and rr is the remote device 


within that node) indicates remote routine; and X’OOnn’ indicates special local routing. If more than 255 remotes are specified for the 
system, this field is set to zero, 


* A change in this field will cause a new type 6 record to be written. 
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ff 
‘ae 





Od 


3800 (non-impact) Printing Subsystem Section: 
SMF6LN2 internal Length of 3800 printing subsystem section, including this 
field 
SMF6CPS binary PCOPYGRP (in *Number of copies in each copy group. Each byte repre- 
PPPWORK)1 sents One copy group, and the sum of the 8 bytes is the 


2 2 
total number of copies printed. 
| 10 SMF6CHR EBCDIC |} DCTCHART1, 2, *Names of the character arrangement tables 
3,4 that define the characters used in printing. Each name is 


4 bytes long, with a Maximum of 4 names. 


EBCDIC | DCTMODF *Names of the copy modification module used to modify 
the data 


EBCDIC | DCTFLASH *Name of the forms overlay printed on the copies 


binary PFLASHC *Number of copies on which the forms overlay is printed 
(in PPPWORK)1 


binary Options indicator 
Bit Meaning When Set 

DCTPPSW2 *O Output was burst into sheets by the Burster- 
Trimmer-Stacker 

PPFLAG2 *4 DCB subparameter OPTCD=J was specified. Each 

(in PPPWORK)1 - output data line contained a table reference 
character that selected the character arrangement 
table used when printing that line. 


2-7 Reserved 


Length of routing section (including this field) 


aa 0 0 SMF6LN3 
( SMF6ROUT DCTNO Output route code2 
SMF6EFMN EBCDIC | DCTFORMS Output form number. This field is set regardless of the 
number of characters in the forms field (SMFG6FMN) 


*A change in this field will cause a new type 6 record to be written. 


JES2 Routing Section: 





- 


IpppwoRK is the print/punch processor work area. 


2 this field is defined as follows: X‘Q0010000' indicates local routing; X‘nnnnrrrr’ (where nnnn is the node number and rrrr is the 


remote device within that node) indicates remote routine; and X‘O0Q0O0Onnnn’ indicates special local routing. This field is always set 
regardless of the number of remotes specified by the system. 
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Record Type 6 (06) — External Writer 


Record type 6 is written by IASXSD82 (external writer). The external writer writes 
this record when processing is completed for a job output element (JOE). If a 
printer is running under the control of a functional subsystem (FSS), record type 

6 is written for each data set printed on that printer. 


This record identifies the output writer by SYSOUT class and form number, and 
identifies the job according to job log identification, JES2-assigned job number, and 
user identification. It also contains information on the output writer activity such 
as the number of data sets processed, and the KCB and universal character set 
identification for the printer. 


If an external writer or user-supplied writer is used, SMF produces an incomplete 
record type 6. SMF produces this incomplete record only when the external writer 
directs output to a printer or punch. If the external writer directs output to a tape 
or disk, then SMF does not produce this record. The incomplete record type 6 
differs from the JES2 record type as follows: 


e. Its length is 88 bytes — offsets 88 and 92 are not produced. 


e The following fields are zero: 
— The number of logical records (offset 51) 
— I/O status indicators (offset 55) 
Subsystem generating identification (offset 62) 
Data set control indicators (offset 66) 
JES2 logical output device name (offset 72) 


| 


| 


Its format is: 


a 
Lo | o| swreten Record length 
5 MVS/XA 
6 VS2 


4 4 SMF6FLG binary SVC 83 System indicator 
7 Reserved 






















Bit Meaning When Set 
0-4 Reserved 


SMF6TME binary SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
10 A SMF6DTE packed SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


14 E SMF6SID EBCDIC} SMCASID System identification (taken from SID parameter) 
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Source Description 


a 


SMF6JBN ~ EBCDIC 


SMF6RST binary 


Job name1 


NO 


SSSOJOBN 
(in SSOB) 


job log2 +4 Time, in hundredths of a second, reader recognized the 


JOB card for this job! 


SMF6RSD packed job log2 +8 Date reader recognized the JOB card for this job, in the 


form OOYYDDDF where F is the sign 


User identification (taken from common exit parameter 
area) 


SYSOUT class. This field is blank for non-SYSOUT data 
sets.) 


SMF6UIF job log2 +12 


NO 


EBCDIC 


A SMF6OWC EBCDIC | SSSOCLAS 


(in SSOB) 


SVC 11 (set by 
IASXSD82) 


108] 


SMF6EWST binary Start time, in hundredths of a second, of print/punch 


processor working on the data in this record 


1 
i 
{ 
if 
I 
j 
i 


SVC 11 (set by Start date of print/punch processor working on the data 


7 


SMF6WSD packed 
\ASXSD82) in this record, in the form OOY YDDDF where F is the 


sign 





zero 
SMF6IOE 
SMFENDS 


binary zero 





Number of data sets processed by the writer and included 
in this record. If multiple copies are produced, each copy 
is counted. (This field included JOBLOG information.) 


binary internal 






ice) 


SMF6FMN EBCDIC | SSSOFORM 


(in SSOB) 


Form number 





0 


SMF6PAD1 
SMF6SBS 


binary Reserved 


E Subsystem identification (x‘0000’ indicates external 


writer) 


binary 


SMF6LN1 
SMF6DCI 
SMF6JNM 


binary internal Length of rest of record, including this field 


2 binary X‘0000’ indicates external writer 


SMF6NLR binary 
Pod 


JCTJOBID +4 
(in SSOB) 


DCTDEVN X‘'0000’ indicates external writer 
DCTFCB 
DCTUCS 


AS 


EBCDIC JES2-assigned job number 


SMF6FCB EBCDIC 
SMF6UCS EBCDIC 


FCB image identification (printer only) 
4 


© ~ fo>) 1 ol i> ae & i#) Ww NO —_ 
7 NO NO ~~ —_ ~ wo NO ~ Oo Oo © 
Oo &] ow | ® io) ©) | G | © NO NO NO NQ _ = = 


sMF60UT | 8 | EBCDIC 
booed 


UCS image identification (printer only) 


The job name and the time and date that the reader recognized the JOB card for this job constitute job log identification. 
The job log is pointed to by SSSOWT RC field in the SSOB data area. 


nN = 
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Record Type 6 (06) — JES3 Output Writer 


Record type 6 is writted by IATOSWD for each data set processed by JES3 output 
service. One type 6 record is written for each copy with a given form name. If a 
printer is running under the control of a functional subsystem (FSS), record type 6 
is written on the processor with the FSS address space for each data set printed on 
that printer. This record is also written for spin data sets. Its length is 116 bytes 
plus 36 bytes for the 3800 (non-impact) printing subsystem section, and 14 bytes 
for the routing section. 


This record identifies the output writer by SYSOUT class and form number, and 
identifies the job according to job log identification, JES3-assigned job number, 
and user identification. It also contains information on the output writer activity 
such as the number of logical records processed, number of data sets processed, 
output service start time and date, I/O status indicators, data set control indicators, 
JES3 logical output device name, and output activity. 


This record also provides information on the activity of the 3800 printing (non- 
impact) subsystem. For additional information on the 3800 printer, see the JBM 
3800 Printing Subsystem Programmer's Guide. 


The format is: 


ee 


2 binary Record length 
2 binary Segment descriptor 


SMF6LEN 
SMF6SEG 
SMF6FLG 


1 binary SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
6 VS$2 
7 Reserved 





SMF6RTY 


SMF6ETME 4 binary SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

SMF6DTE packed SVC 83 Date record was moved to SMF buffer in the form 
OOYYDDDF where F is the sign 


EBCDIC | JMRCPUID System identification (taken from SID parameter) 
EBCDIC | ROJOBNAM Job name’ (taken from job’s RESQ) 


> 


SMF6SID 
SMF6JBN 
A SMF6RST 


4 


a> 


SMF6RSD 


binary JMRENTRY macro| Time, in hundredths of a second, reader recognized the 
(Set by [ATISJB) | JOB card for this job! 

packed JMREDATE macro | Date reader recognized the JOB card for thisjob, in the 
(Set by |ATISJB) form OOYYDDDF where F is the sign! 

EBCDIC | JMRUSEID User identification (taken from common exit parameter 
(Set by [ATOSWD) | area) 

EBCDIC | OSECLASS SYSOUT class. (This field is blank for non-SYSOUT data 

sets.) 


4 1\ATXTOD macro Start time, in hundredths of a second, of output service 


N 


SMF6UIF 


SMF6EOWC 
















(eX) 


2B SMFEWST 


in at JES3 LOGIN time for the writer job. 











(Set by IATOSWP) | working on the data in this record. This field is filled 
4 


A» 
“J 


e) 1 #) NO poet BEN 
NO 


i) N 


2F SMF6EWSD {[ATXTOD macro 


(Set by |ATOSWP) 


Start date of output service working on the data in this 
record, in the form OOY YDDDF where F is the sign. This 
field is filled in at JES3 LOGIN time for the writer job. 


‘The job name and the time and date that the reader recognized the JOB card for this job log identification. 
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C 





















Description 


SMF6NLR 


SMF610E 


SMFE6NDS x binary 






WTRDRCDS or 
PPORCDCT 


internal 


WTRJCOPY or 
PPYSTCPY 






Number of logical records written by the writer, by form 
number and class. (This field is filled in when a data set is 
completed or restarted; it includes repeats and restarts.) 













55 binary 1/O status indicators 


Bit Meaning When Set 
0-4 Reserved 

5 Data buffer read error 
6 Reserved 

Control buffer read error 


56 Number of data sets processed by the writer and included 
in this record. If multiple copies are produced, each copy 
is counted. (This field is filled in.when data set is com- 


pleted or restarted; it does not include restarts. ) 



















57 





SUPFORMS (in 
SUPUNITS entry 
for the output 


Form number — If the source field contains four or 
fewer characters, SMF6FMN will be set. Otherwise, 
this field contains blanks and the contents of the 

source field appears only in SMF6EFMN. 

















SMF6FMN EBCDIC 


SMF6PAD1 Section indicator 


device) 
Bit Meaning When Set 
0 3800 printing subsystem section present 
1 Routing section present 


binary 
{\ATOSWP 
2-7 Reserved 


| SMF6SBS | FESBS binary LATOSWP Subsystem identification — X‘0005’ signifies JES3 


Sauron F6LN1 binary | ATOSWP Length of rest of record, including this field, but not 
including any additional sections indicated by the 
SMF6PAD1 field 


SMF6DCI binary 1ATOSWP Data set control indicators (These bits are set when a data 
set is completed or restarted.) 
j Meaning When Set 
Reserved 
Record represents spin data sets 
Operator terminated this data group 
Operator restarted data set with destination 
Operator restarted this data group 
Received operator restarted data set 
Operator started with single space 
Punch output was interpreted 


SMF6INDC binary internal ~ Record level indicator2 ; 
Bit Meaning When Set 
0-3 Reserved 
4-7. Avalue of X’01’ indicates the first level of the 
restructured SMF type 6 record for JES3 releases 
1.3.1, 1.3.4, and 2.1.5. 


SMF6JNM EBCDIC | RQJNUM or JES3-assigned job number (taken from the job’s RESQ) 
IATOSWD 


SMF6OUT EBCDIC {| SUPDD (in JES3 logical output device name 
SUPUNITS entry 
for the output 
device) 

SMF6FCB EBCDIC | SUPCARR (in FCB image identification (printer only) 
SUPUNITS entry 
for the output 
device) 


2 Each time the record is changed, the value of this field is increased by 1. 





NOOR WN - OD 
~ 
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SMF6UCS EBCDIC | SUPUCS (in UCS image identification (printer only) 
SUPUNITS entry 
for the output 
device) 
SMF6PGE WTRDPGET For printer, approximate page count (A skip to carriage 
6 Some first character control! data bad, default used 
7 Bad record length (truncate or pad) 


- control channel one is counted as a page.) For punch, the 
SMF6DFE binary IATOSWP 
Reserved 


Offsets 






















Data format error indicators (These bits are set when a 
data set is completed or restarted.) 


Bit Meaning When Set 
0-5 Reserved 


number of cards punched. This field is filled in when a 
SMF6OPR OSEPRTY Output priority 


data set is completed or restarted 
SMF6EGRP EBCDIC | SUPGROUP (in JES3 logical output device group name 
SUPUNITS entry 
for the output 
device) 
SMFE6ERSVJ Reserved for JES3 . 


© 
rs 


—_— 
— 
NO 


3800 (non-impact) Printing Subsystem Section: 


SMF6ELN2 


SMF6CPS 


SMF6ECHR 


SMF6MID 


IATOSWP 


OSEMODRC 


EBCDIC | OSECHARS 


EBCDIC | OSEMODID Name of the copy modification module used to modify 
the data. | 
EBCDIC | SUPFLASH or Name of the forms overlay printed on the copies 
PABFLASH 


2 SMF6FLC OSEFLCNT Number of copies on which the forms overlay is printed 


23 SMF6BID = binary Options indicator 


Length of 3800 printing subsystem section, including this 
field 





Number of copies printed in each copy group. Each byte 
represents one copy group, and the sum of the 8 bytes is 
the total number of copies printed. 








Names of the character arrangement tables that define the 
characters used in printing. Each name is 4 bytes long, 
with a maximum of 4 names. 







SMF6FLI 


35 


Meaning When Set 
OSESTACK Output was burst into sheets by the Burster- 
Trimmer-Stacker 
OSEDFLG1 DCB subparameter OPTCD=J was specified. Each 
output data line contained a table reference 
character that selected the character arrangement 
table used when printing that line. 
2-7 Reserved 


<n Hicniaoneee: Length of routing section (including this field) 


Reserved 


i¢%) ie) NO 


JES3 Routing Section: 
SMF6LN3 


SMF6ROUT 


SMFEGEEMN| 8 oo Laiacsecatshin Output form number. This field is set regardless of the 
number of characters in the forms field (SMF6FMN) 


6-28 System Management Facilities (SMF) 








Wy 

















Record Type 6 (06) — Print Services Facility (PSF) 


Record type 6 is written by APSPNST. PSF writes this record whenever data set 
processing is complete, that is, whenever the JES subsystem that PSF is running 
under is informed that the data set is to be released. Its length is 92 bytes plus 36 
bytes for the non-impact printing subsystem section, and 47 bytes for the all-points- 
addressable or APA printing subsystem section. 


The record identifies the output writer according to SYSOUT class form number 
and subsystem identification. It also identifies the job according to job log identifi- 
cation, JES-assigned job number, and user identification. In addition, it contains 
information on the output writer activity such as the number of logical records 
processed, writer start time, and input/output status indicators, logical output 


device name, and number of resources such as fonts, overlays, page segments, 
PAGEDEFs, and FORMDEFs. 


This record provides information in separate sections on the activity of the non- 
impact printing subsystem, and information on the activity of the all-points- 
addressable (APA) printing subsystem. For additional information on the 3800 
printer, see the JBM 3800 Printing Subsystem Programmer’s Guide. For more 
information on the 3800-3 or 3820 printers, see the section “Related Publications” 
in the PREFACE. 


The format is: 


Tories [time | cma 
a ao 
ees 





SMF6FLG SVC 83 System indicator 


SMF6TME binary SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 


















Bit (Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


SMF6SID 


| E | EBCDIC| JMRCPUID System identification (taken from SID parameter) 


EBCDIC}] JMRJOB Job name’ (taken from job’s RESQ) 

26 1A SMF6RST binary JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job? 

30 SMF6RSD packed JMREDATE Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign! 


'The job name and the time and date that the reader recognized the JOB card for this job log identification. 


packed SVC 83 Date record was moved to SMF buffer in the form 
OOYYDDDF where F is the sign 
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SMF6UIF 
SMFG6OWC 


SMF6WST 
SMF6WSD 
SMFENLR 


SMF6IOE 


JMRUSEID User identification (taken from common exit paramter 
area) 

JSPJSOCL SYSOUT class. (This field i is blank for non-SYSOUT _~. 
data sets. ) , 


DIAWST Start time, in hundredths of a second, of output service | 
working on the data in this record. This field is filled in at 
JES3 LOGIN time for the writer job. 


N 


EBCDIC 


EBCDIC 











binary 








packed DIAWSD 





Start date of output service working on the data in this 
record, in the form OOY YDDDF where F is the sign. This 
field is filled in at JES3 LOGIN time for the writer job. © 






binary DIAREC Number of logical records written by the writer, by form 
number and class. (This field is filled in when a data set is 


completed or restarted; it includes repeats and restarts.) 


NO 
NO NO NO 


binary DIAIOE 1/O status indicators 


Bit Meaning When Set 

0-4 Reserved 
Data buffer read error 
Reserved 
Control buffer read error 


binary | internal Number of data sets processed by the writer and included 


in this record. If multiple copies are produced, each copy 


SMF6ENDS 
is Not counted. 


SMFG6FMN | EBCDIC] DIAFORM Form number — only the first 4 bytes appear in this field. 
section present 


61 3D SMF6PAD1 is internal Section indicator 
Reserved 


ge SMF6SBS eM tse Subsystem identification — X‘0007’ signifies PSF 


SMF6LN1 binary internal Length of rest of record, including this field, but not 
including any additional sections indicated by the 
SMF6PAD1 field 


SMF6DC]I binary DIADCI Data set control indicators (These bits are set when a 
data set is completed or restarted. ) 
j Meaning When Set 
Reserved 
Record represents spin data sets 
Operator terminated this data group 
Operator restarted data set with destination 
Operator restarted this data group 
Received operator restarted data set 
Operator started with single space 
Punch output was interpreted 


SMF6INDC binary internal Record level indicator2 





Meaning When Set 

Non-impact printing subsystem section present 
Reserved 

All-points-addressable (APA) printing subsystem 








NOOB WN = OD 
~ 





Bit Meaning When Set 

0-3 Reserved 

4-7 A value of X‘01' indicates the first level of the 
restructured SMF type 6 record for PSF 1.0. 


A value of X‘02’ indicates PSF 1.1. 





“Each time the record is changed, the value of this field is increased by 1. 
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Tories [vane [ema | ome ee 
72 SMF6OUT EBCDIC | CCBPCLBL JES-logical output device name. (For the 3820, ACF 
VTAM logical unit name.) 


| ss | 58 | SMF6PGE DIAPAGE Approximate physical page count 


Length of non-impact printing subsystem section, includ- 
ing this field 






internal 










DIACPY GP Number of copies in each copy group. Each byte repre- 
sents one copy group, and the sum of the 8 bytes is the 


total number of copies printed. 


binary 











Names of the fonts that define the characters used in 
printing as specified in the JCL. Each name is 4 bytes 
long, with a maximum of 4 names. 


DIAFLI Name of the forms overlay printed on the copies 





EBCDIC | DIACHR 


SMF6MID 
SMF6FLI 
22 SMF6FLC DIAFLC Number of copies on which the forms overlay is printed 


EBCDIC 


id ol 
18 
pte | 
| 22 | 





Options indicator 
















Meaning When Set 

0 Output was burst into sheets by the Burster- 
Trimmer-Stacker 

1 DCB subparameter OPTCD=J was specified. Each 
output data line contained a table reference 
character that selected the font used when print- 
ing that line. 

2 Cut-sheet printer? 


3-7 Reserved 





| 35 | 23 SMFG6BID binary DIABID 
DIACSP 


All-Points-Addressable or APA Printing Subsystem Section: These fields contain meaningful data only if the All-points-addressable 
printing subsystem is running under the control of print services facility (PSF). 


SMF6LN4 
eee 
[binary 






Length of the section (including this field) 


£5 ae 
SMF6FONT binary DIAFNTCT Number of fonts used 


2 
fs | 8 | SME6LENT | 4 | binary | DIALFTCT Number of fonts loaded 
SMF6OVLY DIAOVLCT Number of overlays used 


This field is valid only when SMF6SBS equals x‘0007', and SMF6INDC is equal to or greater than x‘02’. 


internal 


w 
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SMF6LOLY ha 
SMF6PGSG a 
SMF6LPSG 


SMF6IMPS 


SMFGFEET 
SMF6PGDF 


DIALOVCT Number of overlays loaded 
DISPSCT Number of page segments used 
DIALPSCT Number of page segments loaded 


4 

4 

4 binary DIASHEET Number of sides of sheets of paper printed (number of | 

logical impressions? | 

DIAFEET Number of feet of document printed. (Zero for the 3820.) 

4 DIAPGDEF Number PAGEFDEFs used 

A 

1 

2 


o) 








Nin y|o 
Ninin{| = =/|= 
Oo}; pn} oO oO rs 










&] ©} & 


SMFGFEMDF DIAFMDEF Number FORMDEFs used | 


| - ye 
45 | 2D SMF6PGOP is internal 


This field is valid only when SMF6SBS equals x'0007', and SMF6INDC is equal to or greater than x‘02’. 


Bin indicators? 





Bit Meaning When Set 

0 Bin 1 used for any part of the data set 
1 Bin 2 used for any part of the data set 
2-7 Reserved 





Duplex indicators? 









Bit Meaning When Set 


0 Standard duplex was‘used for any part of the data 
set 

1 Tumble duplex was used for any part of the data 
set 


2-15 Reserved 


ae: 
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( : Record Type 7 (07) — Data Lost 


Record type 7 is the first record built when an SMF data set becomes available for 
recording after a period when no data sets were available. Data existing in the SMF 
buffer is written to the newly available SMF data set before record type 7 is built in 
the buffer. Consequently record type 7 is not the first record in the data set. It is 
written by IEEMB8729 and its length is 28 bytes. 


This record contains a count of the SMF records that were not written, and the 
start and end times of the period during which no records were written. (The end 
time is the time recorded in offset 6.) 


The format is: 


[ores [Nome [tenat [Format [Sours | ——~S~Ci ton SC*d 
Po [-o | swr7uen | 2 [inary [inwrnar | Record erat 


4 SMF7FLG binary 1EEMB829 System indicator 
| Bit Meaning When Set 
| 0-4 #Reserved 
| MVS/XA 
VS2 
7 VS1 
6 


Oo ol 


i 3 SMF7TME binary {SVC 11 (Set by Time, in hundredths of a second, record was built in SMF 
_ 1EEMB829) buffer 
A SMF7DTE packed {SVC 11 (Set by | Date record was built in SMF buffer, in the form 
|EEMB829) OOY YDODF where F is the sign 
| & | sMF7siID | 4 |EBCDIC |SMCASID System identification (taken from SID parameter) 
SMF7NRO binary |SMCADSCT Number of SMF records lost because no SMF data sets were 
available for recording 
SMF7STM binary SMCADSTM (Set by | Start time, in hundredths of a second, of period during 
1EEMB829) which no SMF data sets were available for recording 
iz — | 


SMCADSTM (Set by | Start date of period during which no SMF data sets were 






1EEMBS29) available for recording, in the form OOY YDDDF where F 


is the sign 
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Record Type 8 (08) — I/O Configuration 


Record type 8 is written by IEEMB823 after the IPL of the system is completed and 
the SET DATE operator command is issued. This record identifies each device that — 


is online at IPL by device class, unit type, and device number. Its length is 20 bytes 
plus four bytes for each device online at IPL. 


The format is: 


[offsets | Name [Length | Format | Soureo [Description 
,O | 0 | SMrLEN | 2 [binary [internat | Recordiength 
2 


Ta -[aweeses [2 [binary [inert] Segment dewgtar 
| SMF8FLG binary |SVC83 
q | 6 vs2 

7 ~vS1 


i 

| 5 | 5 | smrerty | 1 [binary [internat | Recordtype 
ae 
Lee 
















System indicator 

Bit Meaning When Set 
0-4 Reserved 

5 MVS/XA 















SMF8TME binary |SVC 83 Time, in hundredths of a second, record was moved to SMF 
| buffer . 
packed |SVC 83 Date record was moved to SMF buffer, in the form 
~QOYYDDDF where F is the sign 


(14 | E | SMF8siD | EBCDIC | SMCASID System identification (taken from SID parameter) 
F418 | 12 | SMF8LENN fbinary [internal = Length of rest of record including this field | 


For each online device, there is a four-byte entry with the following format: 


SMF8IODV 1 binary | UCBTBYTS3 Device class 
1 binary | UCBTBYT4 _ Unit type 
2 binary | UCBCHAN Device number. 
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Record Type 9 (09) — VARY Device ONLINE 


Record type 9 is written by ICB2MSG (for the 3850 Mass Storage Control), 
IEECLEAN, IEEVPTH, and IEE2303D when a VARY Device ONLINE command 
is processed. This record identifies the device being added to the configuration by 
device class, unit type, and device number. Its length is 20 bytes plus four bytes 
for each device varied online. 


The format is: 


ed 
ToT 0 | swrocen | 2 [oiney [mera | Read 
[2 {2 | swrases [2 [inary [itera | seamentdenrsnor 


il - in - 


|S {5 | smrorty | 1 [binary |internal | Recordtype 


SMFOTME binary |SVC83 Time, in hundredths of a second, record was moved to SMF 

buffer 
A SMFSDTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 

















System indicator 


Bit Meaning When Set 
0-4 Reserved 





5 MVS/XA 
6 VS2 
7 VS1 








114 | E | SMF9SID | EBCDIC. SMCASID System identification (taken from SID parameter) 
18 | 12 SMF9LENN i Length of rest of record including this field 


UCBTBYT3 
UCBTBYT4 
UCBCHAN 









Device class 










binary Unit type 





binary 





Device number. 
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Record Type 10 (0A) — Allocation Recovery 


Record type 10 is written by IEFAB488 after a successful device allocation recovery 
Its length is 44 bytes plus four bytes for each device entry. 


This record identifies the device that is made available by device class, unit type, 
channel address, and unit address. It identifies the job requiring the allocation 
job log identification and user identification. 


Note: This record is not produced if the operator cancels the job instead of 
attempting recovery. 


The format is: 


[otees [Nowe [tees [Forme | sowee [aio 
Co To | swriousn| 2 [ier _[iwrat | Roord nw 





SMFIORTY 


| 2 { 2 | SMFtosEc | 
4 SMF10FLG binary {SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
MVS/XA 
VS2 
) VS1 


[binary internal ———=d|=CRecordwpe SSCS 
SMF10TME binary |SVC 83 Time, in hundredths of a second, record was moved to SMF 
, buffer 
A SMF10DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OO0Y YDDDF where F is the sign 
114 | & | SMFi0sID | 4 — EBCDIC |SMCASID System identification (taken from SID parameter) 
18 SMF 10JBN EBCDIC | JMRJOB Job name. This field contains blanks if allocation recovery 
is for a system task . 
SMF1ORST binary |JMRENTRY Time, in hundredths of a second, reader recognized the JOB 
card for this job. This field equals zero if allocation recovery. 
4 packed |JMREDATE Date reader recognized the JOB card for this job, in the form 
OOYYODDDF where F is the sign. This field equals zero if 
allocation recovery is for a system task 1 


















is for a system task 2 
SMF 10UIF | EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area) | 
SMF10LN Length of rest of record including this field | 


UCBTBYT3 Device class 
UCBTBYT4 Unit type 


| UCBCHAN Device number. 
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a 


4 mY 


























Record Type 11 (OB) — VARY Device OFFLINE 


Record type 11 is written when a VARY Device OFFLINE command is processed. 
It is written by ICB2MSG (for the 3850 Mass Storage Control), IEECLEAN, 
IEEVPTH, IEFAB421, IGCOOOSI, and IGCO905I. This record identifies the device 
being removed from the configuration by device class, unit type, and device number. 
Its length is 20 bytes plus four bytes for each device varied offline. 


The format is: 


Tories [Name [tenon | Forme [Sous [Cito 
fo | o | smrien | 2 | binary | internal Ss |_—sRecordiength 
| 2 | SMF1ISEG | 2 [binary |internal | Segmentdescriptor 


| SMF11FLG iy SVC 83 System indicator 


Bit Meaning When Set 
rs [8 | swriinry | 1 [binary |ineernat | Record wpe 


0-4 Reserved 
5 MVS/XA 
6 VS2 
. Reserved ; 
SMF11TME binary {SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
A | SMF11DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDOF where F is the sign 
14 | & | smF1isip | 4 | EBCDIC | SMCASID System identification (taken from SID parameter) 
fie { 12 | SMF11LN | 2 | binary | internal Length of rest of record including this field 


For each device varied offline, there is a four-byte entry with the following format: 












+0 SMF11DEV 1 binary { UCBTBYT3 Device class 
+1 1 binary UCBTBYT4 Unit type 
+2 2 binary | UCBCHAN Device number 
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Record Type 14 (OE) — INPUT or RDBACK Data Set Activity .; 
Record type 14 is written for non-VSAM direct access or tape data sets that are ae 
defined by DD statements or dynamic allocation and opened for INPUT or 
RDBACK processing by problem programs. It is written by IFGO202H and 
IFGO202I when a data set, as described above, is closed or processed by EOV. Its 
length varies from 292 to 6,416 bytes, depending upon the number of volumes for 
the data set. 

This record contains information (associated with both the access method used 
and the type of data set used) from the TIOT, JFCB, DCB, DEB, and UCB data 
areas. For more information about these data areas, see Debugging Handbook. 
Note: Record type 14 is not written for a data set defined by a DD* or DD DATA 
statement. For accounting purposes, the card-image count for these data sets is 
provided in record type 4. | 

_ The format is: | 
a Cd 
o [0 | smriaten | 2 | binary [internal | Record length 
Pa [2 | smeiases [2 [binary internat | Segment dererstor SSCS 
| 4 | SMF14FLG binary |SVC 83 System indicator 
| Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
| 6 VS2 
7 VS1 
SMF14TME binary |SVC 83 Time, in hundredths of a second, record was moved to SMF 2 y 
buffer ~ 
A SMF14DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDODDF where F is the sign 
(14 | & | smFi4sin | 4 | EBCDIC | JMRCPUID System identification (taken from SID parameter) 
/18.| 12 | SMF14BN | 8 | EBCDIC | JMRJOB Job name? | 
1A. SMF 14RST binary |JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job } 
30 packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYYDODF where F is the sign 1 
} 34 | 22, SMF 14U1D | 8 | EBCDIC | JMRUSEID User identification (taken from common exit parameter area) 
42 | 2A SMF 14RIN 2 binary Record and data set indicator 
Bit Meaning When Set 
0 Reserved 

internal 1 Record written by EOV (Register 14=0 if CLOSE; 
register 14=4 if EOV) 

UCBTYP 2 DASD device 

JFCBDSNM 3 Temporary data set. (A data set is temporary if it 
has a system-generated name, is created within a job 
or job step, and exists only for the duration of that 
job or job step.) 

DCBDSORG 4 DCBDSORG=DA. (The data set organization being 
used is direct access.) 

DCBDSORG 5 DCBSORG=!IS and DCBMACRF not EXCP. (The 
data set organization being used is indexed sequential 
and the EXCP access method is not being used.) 

JFCDSORG 6 JFCDSORG=IS. (The data set organization being 

(in JFCB) used is indexed sequential.) 

7 VIO data set 
8-15 Reserved 
1The job name and the time and date that the reader recognized the JOB (Continued) 


card for this job constitute the job log identification. 
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Section Sizes: 
44 2C | SMF14SDC binary | internal Size of DCB/DEB section. This field equals 24. 
SMF14NUC 7 binary | internal Number of UCB sections. There is always one UCB section 














volume for primary extents, and one for the overflow extent. 
For BPAM-concatenated data sets, there is one UCB section 






for each UCB currently processing except for ISAM and 
SMF14SUC binary | internal 


BPAM-concatenated data sets. For ISAM data sets, this 
SMF14SET 


field is calculated as: one for the index extent, one per 





internal 





binary 


SMF140PE 


co 











binary | TIOESTTA 





















binary | TIOESTTC 














binary 





binary 


A| SMFDCBOP 
SMF 14RV2 


FC | SMFDEBFL 


Tl nn 
J 


for each data set in the concatenated data set. 
Size of ISAM extension section. This field equals 28 
(or O if there are no ISAM data sets). 
binary | internal _ Time, in hundredths of a second, when the data set was. | 
opened. 
TIOT Section — a portion of the TIOT, including: 
entries) , 
SMFTIOE2 Status indicator. This field indicates the tape label 
processing to be performed; whether unallocating, 
whether this is the first DD entry for a split cylinder. 
SMFTIOE3 binary |TIOEWTCT Number of devices requested for this data set during 
allocation 
37 | SMFTIOE4 binary | TIOELINK During allocation, this field indicates a link to the 
appropriate prime split, unit affinity, volume affinity, or 
suballocate TIOT entry. After allocation, it is a data set 
and device indicator. 
SMFTIOE6 binary |TIOEJFCB Relative track address (TTR) of the JFCB. During 
allocation, this field contains the TTR of the SIOT. 
67 SMFTIOE7 Status indicator during allocation only and set to zeros at 
affinity, volume affinity, and suballocate TIOT entry are 
| primary or secondary. 
JFCB Section: | 
68 | 44 SMFJFCB1 176 binary |JFCB The JFCB, excluding JFCB extensions 
SMFOCBRF binary _[DCBRECFM 
DCBMACRF | __ Type of 1/O macro instruction and options 
SMFDCBFL DCBOFLGS Indicator used by the OPEN routine such as the type of the 
last |/O operation, and the return from the user's exit 
binary DCBOPTCD Option codes used by access-method interfaces 
binary 
binary |DEBOFLGS Data set and device status indicator. This field indicates 
status of DASD. 
Indicator showing both the method of I/O processing and 
the disposition that is to be performed when an end-of- 


Size of each UCB section. This field equals 24. 

34 | SMFTIOE1 1 | TIOELNGH Length, in bytes, of the DD entry (including all device 
rewinding, or unloading tape data sets is required; and 

SMFTIOES5 EBCDIC | TIOEDDNM DDname 
the end of allocation. This field indicates whether the unit 
DCB/DEB Section — portions of the DCB and DEB, including: 

F4 |} SMFDCBOR 2 binary |DCBDSORG Data set organization being used 
whether a data set is modified, new or old, and shows the 
volume (EOV) condition occurs. 








SMFDEBOP 





binary j|DEBOPATB 










Volume sequence number. For direct access, the sequence 
number is relative to the first volume of the data set. For 

tape, the sequence number is relative to the first volume 
processed, This field is valid only for sequential data sets. 


SMFDEBVL binary |DEBVLSEQ 






244. 
247 
250 | 
a 


(Continued) 
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For each DCB/DEB tape extension, there is a 12-byte entry with the following format: — 
SMFDCBBL 4 binary | OCBBLKCT 





Block count for each volume 


+0 
rs4_[ | smeossno | 6 [escorc| ucesac | Dataset serial mimber_—— 
fof [swetanva [2 [bie [| (Rewed SCSCSCS~SCS 


The following 12 bytes apply to the DCB/DEB DASD extension: 


+O . SMF14NTU 4 binary. | DCBFDAD Relative track and concatenation number (TTRN) of the 
| last record processed for a physical sequential or partitioned 
data set. N is always zero except for BPAM-concatenated 
data sets. If the last operation was a read (DCBOFLGS 


bit 0 is off) the TTR is: (1) zero, (2) the start of a BPAM 
member if there are two or more IOBs, or (3) the last write 
of the data set if there is one IOB. This is true because the 
access method maintains DCBFDAD while reading only if 
RECFM=FS, RECFM=FBS, or only one 1OB (BUFNO, 
NCP) is used. 


SMF 14NTR TCTTKRLD Number of tracks released by the DADSM routine 


| | SMF14NER | 1 [binary | TCTEXRLD Number of extents released by the DADSM routine si 
[| | SMFi4nv4 | 3 [binary | iL Reseed 


‘UCB Section — a portion of the UCB (see offsets 45 and 47), including: 
SMFUCBDV UCBCHAN Device number 


SMFSRTEV UCBVOLI Volume serial number 
SMFUCBTY 


4 SMFSRTES at UCBSTAB DASD volume status indicator. This field indicates whether 





+} +] + 
al 






& B 
oO} 





+ 
ah 
N 






this DASD volume is a private, public, storage, or control 
volume. 
SMF TANEX internal (in DEBI 


SMFEXCP 4 binary | TCTDCTR EXCP count for entire step. Note that if a data set is 
opened and closed twice during a single step, the count in 
| the second type 14 record is the sum of al! EXCPs for both 
uses of the data set. (The EXCP count in the last type 14 
record for the step is equal to the corresponding entry for 
| the data set in record type 4. For more information about 
| EXCP count, see Chapter 8. 


For each UCB tape extension, there is a four-byte entry with the following format: 


+] + 
ah | ant 
&] w 


+ 
=~ 
Oo) 








| UCBFSCT Data set sequence count 


| SMFSRTEQ| 2 | binary | UCBFSEG 


The following four bytes apply to the UCB DASD extension: 








DEBNMTRK for Number of tracks allocated on the device 
all extents 


Reserved | 
DCBMAC Extension of 1/O macro instruction field (DCBMACRF) 


SMFDCBMA 
for ISAM 


| | smFpcent| 1 [binary | DCBNLEV Number of index levels - 
5 SMFDCBR3 ts binary DCBRORG3 For each use of the data set, number of read or write 


accesses to an overflow record which is not first in a chain 
of such records 


DCBNREC Number of logical records in the prime data area 


+12 | SMPDCBR2 2 binary | DCBRORG2 





SMFDCBNR 


ao ae a sah aS Le Se 


Number of tracks (whoie or partial) remaining in the 
overflow area 





\ These fields are zero for DD DUMMY and spooled data sets. (Continued) 
For virtual |/O data sets, the device number is X’7F FF’. When the high order bit is on in the device number 
field, a virtual device is indicated. 
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[—oteas [Name [uenat] Format] Sows [Carin 


ISAM Extension Section: (Continued) 
SMFDCBNO 2 binary | DCBNOREC Number of logical records in the overflow area 


DCBRORG1 Number of cylinder overflow areas that are full 






+ 
—_ 
A > 





SMFDCBR1 













SMFDEBNI 


a I 

ae 1 [bi | 

_ [i [einary[BEGNIEE [Numa of extents n he Tdopendent nde rea 
-—Tewepeene | 1 

+21| | SMFDEBNO| 1 | 

[—~Jswencves [2 [os 

—Tewrneve [2 
Lo | 2 | 


SMFNOCYL 
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Record Type 15 (OF) — OUTPUT, UPDAT, INOUT, or OUTIN Data Set Activity 4 ° 
Record type 15 is written for non-VSAM direct access or tape data sets that are 

defined by DD statements or dynamic allocation and opened for OUTPUT, UPDAT, 

INOUT, or OUTIN processing by problem programs. It is written by IFGO202H and 

IFGO202I when a data set, as described above, is closed or processed by EOV. Its 

length varies from 292 to 6,416 bytes, depending upon the number of volumes 

for the data set. 


This record contains information (associated with both the access method used 
and the type of data set used) from the TIOT, JFCB, DCB, DEB, and UCB data 
areas. For more information about these data areas, see Debugging Handbook. 


Note: Record type 15 is not written for data sets defined as SYSOUT data sets on 
DD statements. For accounting purposes, the SYSOUT logical record count is 
provided in record type 6. 


The format for this record is the same as the format for record type 14. 
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( Record Type 16 (10) — DFSORT Statistics 


Record type 16 is written by IGX00017 and IGX00038 to record information 
about events and operations of the IBM DFSORT licensed program (5740-SMI). 
Depending on the option specified at initialization and whether or not DFSORT 
executes successfully, a full record, a short record, or no record is produced. 

| See DFSORT Planning and Installation for a discussion of the type 16 SMF 

| record. DFSORT also passes an SMF record to an installation’s ICETEXIT 
termination exit. 





The format is: 


SMF16LEN 2 


To 
[2 [sueveses | 2 


io | 
EZ 


5 ICERTYPE binary 


Le 
i 
Lad 
Ll nel il 
Be 
ised 
Lo 
bee 
ee 


















internal Record length? 
Segment descriptor” . 


System indicator 


Format 





binary 
internal 


SVC 83 


binary 
binary 


Bit Meaning When Set 

0 Subsystem name follows standard header” 
1-4 Reserved 

5 MVS/XA 





internal Record type 


SVC 83 Time, in hundredths of a second, record was moved to 
MF buffer 






6 
S 


A | ICEBDATE | 4 packed 


r 
2 
[ao [18 | icenos | 
A 


SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
SMCASID System identification (taken from SID parameter) 


n.d ; 
2 
IMRENTRY 
. 3 


EBCDIC 


vs 
] 
2 
EBCDIC 3 


2 
binary i 


packed 


44 2C ICETRN 2 binary internal Number of triplets supported by DFSORT.* A triplet 
| is a set of offset/length number values which define 
an SME record section. These descriptors begin at 
ICEPROD.! 
1 


This field will always be included in the SMF record. 















a This field is provided by SMF when a record is moved to an SMF buffer. If SMF is active, this field will be included in the 
written SMF record. If SMF is not active, no SMF record is written and this field will not be available. This field is never 
available in the SMF record passed to the DFSORT ICETEXIT. 

: This field is provided only if the JOB Management Record control block is available to DFSORT. 

4 


Depending on the application, this number may not be representative of the number of SMF record sections that DFSORT 
actually provided in its SMF record. 
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Oo 
77) 


N > 


ff. Format 
ICESUBID EBCDIC 


ICERSUB 2 binary 


ets Length 


E 
52 


aie 
© 
NO 


Record subtype 

X‘01': Short record, successful execution> 
X‘02’': Full record, successful execution? 
X‘03': Short record, unsuccessful execution 


internal 


5 





f 


ICEPROD 
ICEPRODL 
ICEPRODN 


binary 
2 
2 


internal Product section length? 


internal Number of product sections. This field will be zero if 
no product section is provided.» 


0 


binary 


binary 


Cc 
40 


CEDATA 
ICEDATAL 
ICEDATAN 


binary 
2 
2 


binary 


internal Common data section length> 


internal Number of data sections. This field will be zero if no 
data section is provided.> 

internal Offset to record length distribution section.” 

internal Record length distribution section.» 


internal Number of record length distribution sections. This 


binary 


4 
8 
A 


ICESTAT 
ICESTATL 
ICESTATN 


| binary 
2 
2 


binary 


Ss 
BAS 


binary 


field will be zero if no record length distribution 
section is provided.” 


Reserved. 


EBCDIC | ACEEUSRI User ID for which the job or session is being executed. 
This field is only provided when RACE is installed.> 





C 4 


0 


ICERES1B 
ICEUSERN 


Oo 


NS ag oO oftafa 
oO o RIN rs Ola ir 
IS 


58 ICEGROUP EBCDIC | ACEEGRPL Group ID for which the job or session is being 


executed. This field is only provided when RACF 
is installed.> 





Product section: 
+0 ICERECV 2 EBCDIC | internal 
+2 ICEPRDCT EBCDIC 

A | ICERELNM EBCDIC 
+E ICERESIC 


Record version.» 


internal Product name: '5740-SM1"> 
internal DFSORT Release/Level e.g. "9.9" 


+ 
© 





j+2 | 42 | iceproct | 
0 | +a | ICeRELNM | 
| +6 | Icerestc 


Data section:° 


4 


+ 
= 
SS 
NO 


Reserved ; 


internal Reserved | 


internal Stepname; blank if no stepname> 
internal Number of records sorted ’ | 
internal Number of bytes sorted (sum of record lengths) ’ 





ICERES2 
2 ICESTPNM 
+A | ICERCDS 
E ICEBYTES 


binary 
EBCDIC 
binary 


Ba 


4 


4 binary 


+]+ 7+ 7+ 
—_ Ff i Ff or F AD 
aoprATo 
ala 


12 | ICECPUT binary SVC 46 Sort processor time, hundredths of a second” 
+22 +16 | ICELEN 2 binary internal Specified record length? 
5 


This field will always be included in the SMF record. 


° Since ICERCDS, IECBYTES, ICECPUT, and ICEWBLK are not each on full word boundaries within the DSECT for the data 
section, alignment errors will occur when assembling programs referencing these fields as full word fields. 

q Refer to message I1CE1341 for a description of the meaning of the number of records/bytes sorted. This field contains a value 
which is applicable at the time of termination. If DFSORT terminates abnormally it may not be an identical value to what is 
provided when termination is successful. 

. iCECPUT wiii be set to zero if STIMER=NO and may or may not be zero if DFSORT's invoker is also using the CPU TIMER. 
This field will always be included in the SMF record. 

9 


This field will not be provided if DFSORT terminates abnormally (i.e. with record subtype X‘03’). 
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internal Subsystem identification” 


internal Offset to product section? 


internal Offset to common data section” 


o \ 
x \ 
Hi 
a | 



































Offsets 


Length [Format | Source | Cescription =— 
2 Maximum input blocksize or control interval size! ° 
2 Maximum output blocksize or control interval size! ? 


2 binary internal Total control field length (number of bytes actually 
compared by DFSORT).!? 
Number of work data set tracks used! : 
binary internal 
data sets were not needed). ! 
Reserved 


Number of allocated work data sets! . 


2 System indicator 
] Meaning When Set! 
A sort was specified! a 
A merge was specified! * 
A copy was specified? @ 
Reserved . 
| 


binary internal Time, in hundredths of a second, DFSORT started 
processing! ° 
packed internal Date DFSORT started processing, in the form 
OOYYDDDF where F is the sign. ° 


ICEIBLK and ICEOBLK are set to zero if the corresponding data set (input or output, respectively) is not present. This field 
will not be provided if DFSORT terminates abnormally (i.e. with record subtype X’03’). 





ICEIBLK 
ICEOBLK 
+28 +1C | ICEKEYLN 












e 
iéS) 
oS 
A 
m 


1 ICEWBLK 


eo 
fae 
ee 
+34 | +22 | ICEFLBYT ; 
ale 


Bit Meaning When Set 
Reserved 
{°° 00=Fixed-length records! ! 
01=Variable-length records! : 
10=Variable-length spanned records? 
3-4 00=Blockset? ? 
01 =Peerage! a 
10=Vale!? 
11=Conventional and merge 
5 lf DFSORT program invoked (not invoked 
by JCL or CLIST) 
6 Sorting was completed in memory (work 


12 14 


+35 +23 | ICENDYNA 
+36 +24 | ICERES3 





+37 +25 | ICERES3 
+40 +28 | ICETIMES 


3 
4 


+44 +2C | ICEDATES 





tt This field will not be provided if DFSORT terminates abnormally (i.e. with record subtype X‘03’). 

12 This field contains a value which is applicable at the time of termination. If DFSORT terminates abnormally it may not be an 
identical value to what is provided when termination is successful. 

“ lf ICEFLBYT bits 1-2 are binary zeroes (indicating a fixed-length record), the short form of the SMF record is produced, 
even if the user has specified the full SMF record. In addition, ICERSUB is initialized to X‘0001’ to indicate that the short 
form has been produced. 

14 The following fields will be provided for the Conventional technique SMF record: 

e All of the fields in the header section except ICETRN, ICEUSER and ICEGROUP. 

e ICERECV and ICEPRDCT in the Product section 

e ICESTPNM and the technique and program invoked flags of ICEFLBYT in the Data section. 
ae all bits of ICEFLBY2 are zero, then the function to be performed could not be determined. 

16 


This field will always be included in the SMF record. 
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456 | +38 |ICERCBYT yo internal 





Length | Format 


ICETIMEE binary internal Time, in hundredths of a second, DFSORT ended — | 
processing! 


Offsets 
+48 +30 


+52 +34 |ICEDATEE packed internal Date DFSORT ended processing, in the form . 
| OOYYDDDF where F is the sign.! ® | 
Return code status! : 


Meaning When Set 


System abend detected’® 
User abend detected! ° 
Reserved! ” 

User requested ABEND issued by DFSORT!® 


RC = 16 returned to caller! © 
RC = 20 returned to caller! © 
Reserved! t 


Return code of DFSORT to its invoker. This field will 
contain X‘FF’ if a user requested or system ABEND is 
issued. 6 





457. | +39 lICERC wind fnitaraal 
; “ee & 


at 
4 
1 
1 
2 
2 
2 
4 
4 
3 


binary internal Reason code. If ICERC is not zero, then this field will 
contain the system or user ABEND code, or the number 


of the DFSORT message describing the reason for an 
unsuccessful execution.! 


Reserved 











ICEWKFLG binary internal Work data set flags byte 
| | Bit Meaning When Set 
0 Work data set tracks were allocated 
dynamically! ° 
1-7 Reserved! 


476 oe ee Zz 


ICEWEXE binary internal Number of extents allocated for all work data sets when 
sorting ended.’ 
ICEWALLS binary internal | Number of tracks initially allocated for work data sets 
| when sorting ended. § 
18 


binary internal Number of tracks allocated to work data sets when . 
sorting ended 


16 This field will always be included in the SME record. 
Af This field will be zero if termination is normal. 
18 


This field contains a value which is applicable at the time of termination. If DFSORT terminates abnormally it may not be 
an identical value to what is provided when termination is successful. 
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Pa 


ff 
/ 


fg 
Me 


ae 


Ny 
) 


~ 


CEWEXS ee internal pumeber of extents initially allocated for all work data Bee oh 
sets. 




















Length 


Offsets 


+83 +53 | ICEIAMB 1 binary internal SORTIN access method byte 
Meaning When Set?° 


SORTOUT used Excp!? 
SORTOUT used VSAM! ? 
SORTOUT used BSAM! ” 
3-7 Reserved 

u 


internal Number of calls to the access method that was used 
for SORTIN.2! 


Reserved 


binary internal SORTOUT access method byte 


Meaning When Set? 

SORTOUT used ExcP!? 

SORTOUT used VSAM!” 
2 SORTOUT used BSAM!? 
3 Reserved 


-7 
internal Number of calls to the access method that was used | 
for SORTOUT.'? 7? 
internal Number of EXCPs for all work data sets.’ ” 


ASCBSRBT Cumulative value of the SRB time for the region when 









+84 +54 | ICEINIO binary 


é 
Oo 
00 


+58 
+91 +5B 


ICERES6 
ICEOAMB 


1) 


ICEOUTIO 


6 
N 


+5C binary 


+60 | ICERES7 
+64 | ICEWKIO 
+68 | ICESRBTS 


ze 
© 
©) 


binary 


4 binary 


DFSORT started processing, in hundredths of a 
second?” 





Cumulative value of the SRB time for the region when 
DFSORT ended processing. The difference between 
this value and the start SRB time will be the SRB time 
expended for sorting, merging or copying, provided 
there was no other activity in the region. 


Number of TCBs defined in the region while DFSORT is 
processing. If the number is different at the end of 
processing from the number at the start of processing 
this field will contain the larger number.” 


Reserved. 


+6C | ICESRBTE binary ASCBSRBT 








| al eis 
2) 
Oo 







112 +70 | ICETCBS 2 binary ASXBTCBS 


114 +72 | ICERESS 


19 This field contains a value which is applicable at the time of termination. If DFSORT terminates abnormally it may not be 
an identical value to what is provided when termination is successful. 

20 if all the bits of ICEIAMB or ICEOAMB are zero and DFSORT terminated abnormally, then the type of access method used 
for SORTIN and SORTOUT could not be determined. 

21 The number of calls to the access method used for a particular data set will be the total count of EXCPs, or READ/WRITEs 
(BSAM), or GET/PUTs (VSAM). 

ae 


This field will always be included in the SMF record. 
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an a) lh 
Picectnoz | [inary | internat | Records wih engin 16977 
Picecrros [+ [inary | interar | Record withinatn aaa" 


offsets | Name | Length_ 


+ 
+4 
+8 


ICECTRO4 | 4 | binary | internal | Records with length 64-1272° 
ICECTRO5 | 4 [binary | internal Records with lengths 128-1917 | | 


+] + 
we fF od Oo 
Orin 





ICECTROG 
ICECTRO7 | 


8 
NO 
oe) 


8 
NO 
B 


Records with lengths 256-51 qe 
Records with lengths 512-10237° 


+ 
NO 
© 


ICECTR13 


Records with lengths 1024-2047 2° 
| 4 | binary | internat _—_[{_ Records with lengths 2048-40957° 


Records with lengths 4096-71672° 
Records with lengths 7168-10751 23 


Records with lengths 10752-153592° | 
ICECTR14 Records with lengths 15360-20991 7° 
ICECTR15 Records with lengths 20992-26623"° 


ICECTRIG Records with lengths 26624-327562° | 


This field is provided if SMF=FULL is specified for a successful variable record length sort/merge. 


Records with lengths 192-2557 


a8 
WIG 
OFM 


+ 
f& 
(o>) 


+1 + 
res 
co; Ss 


BE 
Oly ol 
Orn 






Pa 
a) 





23 























NO] NO _ —_ 
mi > 











‘Record Type 17 (11) — Scratch Data Set Status 


Offsets 
SMF17LEN 
SMF17SEG 


SMF17FLG 


SMF17RTY 


SMF17TME 
A SMF17DTE 


SMF17SID 
SMF17JBN - 


SMF17RST 
SMF17RSD 


SMF17UID 


SMF17RIN 
_ SMF17DSN 


SMF17RV1 


SMF17NVL 


> 


OQ}; > 


4 


co 


Length 





Record type 17 is written by IGGO290D when a non-temporary data set or a tem- 
porary data set is scratched. This record contains the data set name, number of 
volumes, and volume serial numbers. Its length varies from 100 to 2,140 bytes, 
depending upon the number of volumes for the data set. 


Note: You use the REC parameter in the SMFPRMxx parmlib member to specify 
whether information for record type 17 is to be collected. REC(ALL) 
specifies that record type 17 is to be written for both temporary and non- 
temporary data sets. REC(PERM) specifies that record type 17 is to be 
written only for non-temporary data sets. 


The format is: 


Description 


binary | internal Record length 


internal Segment descriptor 


binary 
System indicator 


Bit Meaning When Set 
0-4 Reserved 


binary 





5 MVS/XA 

6 VS2 

7 VS1 
binary | internal Record type 


SVC 83 Time, in hundredths of a second, record was moved to SMF 


buffer 


binary 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


SMCASID System identification (taken from SID parameter) 
EBCDIC | JMRJOB Job name? 


packed |SVC 83 





EBCDIC 


JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job? 


packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign’? 


EBCDIC | JMRUSEID ; User identification (taken from common exit parameter 
area) 


binary 


binary Reserved 
EBCDIC 


binary 


user’s parameter list | Data set name 
Reserved 
binary | user’s parameter list | Number of volumes 


For each volume, there is a eight-byte entry with the following format: 


3 


SMF17RV2 
+2 SMFI7FVL 


binary Reserved 
EBCDIC | user’s parameter list | Volume serial number 


1The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 


i 


Chapter 6. SMF Records 6-49 








| 
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| 
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i 
| 
| 














Record Type 18 (12) — Rename Data Set Status | i 
| | Ne 
Record type 18 is written by IGGO3001 when a non-VSAM data set that is defined 
by a DD statement (either explicitly or implicitly) is renamed. (When a DD 
statement defines a volume, all the data sets on that volume are implicitly defined.) 
This record contains the old data set name, new data set name, number of volumes, 
and volume serial numbers. Its length varies from 144 to 2,184 bytes, depending 
: upon the number of volumes for the data set. 
| The format is: 
! | 
[oftets | Nawe  [usnath] Former | Sours —SSSSCeiption 
ho | o| SMF18LEN — ee binary ners sd Record length | 
SMF18SEG Segment Descriptor 
SMF18FLG | ISVC 83 System indicator 
| Bit Meaning When Set 
| 0-4 Reserved 
| 5 MVS/XA 
| | 6 vS2 
res [1 [einery [ineernat | Recorsyee—SSSSCSCSCSC~S 
SMF 18TME binary |SVC 83 | Time, in hundredths of a second, record was moved to SMF 
| buffer 
A SMF18DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 
14 | E | SMF18SID Ps eae EBCDIC | SMCASID System identification (taken from SID parameter) oo 
26 1A SMF18RST binary |JMRENTRY Time, in hundredths of a second, reader recognized the JOB 
card for this job 1 


SMF 18RSD 
EBCDIC | JIMRUSEID User identification (taken from common exit parameter 
: area) 


1 

4 
2C | SMF180DS | 44 | EBCDIC |user’s parameter list | Old data set name 7 
aa[ea | swrieavi | 3 [binary | sd Reeved —CSC“—~—S~—“C—sSsS*SsS 


fas [a7 [_smrvewve Number of volumes 


SMF18RV2 Reserved 
SMF18FVL EBCDIC | user’s parameter list | Volume serial number 


packed | JMREDATE Date reader recognized the JOB card for this job, in the 
. | | form OOY YDDDF where F is the sign: 2 
| SMF18UID 


| SMFI8RTY 





1The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 
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Record Type 19 (13) — Direct Access Volume 


Record type 19 is written by IGCO107H (1) for each direct access device that is 
online at IPL, (2) for each direct access device that is online when a HALT EOD 
or SWITCH SMF command is processed, and (3) when a volume that is defined 
by a DD statement is demounted. Its length is 68 bytes. 


This record contains the volume serial number, VTOC address, owner 
identification, unit type, number of unused alternate tracks, number of unallocated 
cylinders and tracks, number of cylinders and tracks in the largest free extent, and 
number of unallocated extents. It also contains the device number and module 
identification for devices having movable address plugs. 


Notes: 

1. Record type 19 is not produced for DOS volumes used under the operating 
system. 

2. In order to determine the latest status of a shared file, the CPU clocks must be 
synchronized. 
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The format is: 


<2 Ls NT 


| 2 | SMF19SEG [2 [binary | internal ——|_ Segment descriptor 


il 7 LE 7 


System indicator 
Bit Meaning When Set 
0-4 Reserved 


MVS/XA 
VS2 
VS1 





Time, in hundredths of a second, record was moved to SMF 
buffer 


Al al 
SMF 19DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDODF where F is the sign 


faa | c£. SMF 19S10 | 4 | EBCDIC | SMCASIO System identification (taken from SID parameter) 
rie_[a2 | swrrenvi[ 2 [binery | id seed 


SMF19VOL EBCDIC! volume labei2 Volume serial number 
(VOLSERNO) 
1A: SMF 19010 EBCDIC] volume labei? Owner identification of direct access volume 
(VOLOWNER) 


af oe eoripoe| some UcBTYP [unites —™—~—CSSCS 


fal ee SMF19VTC aa binary | volume label? 


(VOLVTOC) 





VTOC indicator 
Bit Meaning When Ser 

Format 5 DSCBs missing or erroneous 
Reserved 
VTOC does not begin on record 1 
Accurate Format § and 6 ODSCBs; bit 0 set to 0 
Possible VTOC or VTOC index error2 
VTOC error has been fixed; bit 5 set to 0 
Indexed VTOC 


SMF 19VT1 binary | DS4VTOCI 
fin OSCB4) 
DS4D0SBT 
DS40STKP 
DS4DICVT 
DS4DIRF 
DS4D0ICVT 
| | DS44VTOC 
Number of OSCBs, caicuiated as: number of OSCBs per 


46 binary internal 
track times number of tracks in VTOC 
48 binary | DS40SREC Number of OSC8QOs, that is, number of available OSC8s 
(in OSC8B4) 


SMF 1ISNAT binary | OS4NOATK Number of unused aiternate tracks 
(in OSCB4) 


es ee Seem ae 
Ts6 [se | SMPTOLEX{ 2 | binary | internal (OSCBS) | Number of eylinders in the largest unallocated ent 
Tse _[3a |_| 2 | binary | internal (0SCBS) | — Number of tracks in te largest unallocated extent 
Peo_[ 3c | SMFIONUE| 2 | binary | inernal (OSCE) | Number of unallocated extents 
rez [36 | SMPIgRV3[ 2 binary [|__| RewnedOSSCSCSCSSCSCSCS 





eu [40 [ swrrecuu| > [ery [ucecHan | Owienamier | 
66 | 42 SMF1I9IND 2 internal Module identification or drive number indicating physical 


binary 
; identity of devices having moveable address piugs. This 
field is taken from bits 2-7 of sense byte 4 for these 
devices. (Sea the component descrintions of these devices 


wey vweweaw —-— ware —— 


for the meaning of sense byte 4.) 





‘The volume label for the direct access device is record 3 of cylinder O of track 0. 
2 


Bit 5 may be set for SMF record 19 even though it may not be set in Format 4 DSCB for an indexed VTOC when active 
VTOC Recording Facility (VRF) data is present in the VTOC index. 
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VTOC address 

















Record Type 20 (14) — Job Initiation 


Record type 20 is written by IEFSMFIE at job initiation (including TSO logon). 
This record contains the job log identification, user identification programmer’s 
name, number of accounting fields on the JOB statement, accounting fields, and 
RACF-related information. Its length is 65 bytes plus the length of the JOB 
statement accounting fields and the relocatable RACF section. 


The format is: 


[orima [name [tn [Fomer [tower [ein 
a SMF20LEN| 2 | binary |internal _—S=_| Record a 


| SMF20sEG| 2 | 62 | binary | binary [internal internal =| Segment descriptor, descriptor 


SMF 20F ei binary |SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
MVS/XA 
VS2 
VS1 


22 Ce a CTS 


binary jSVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
10. SMF 20DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDOOF where F is the sign 


| smF20sin | 4 | EBCDIC | SMCASID System identification (taken from SID parameter) 


za SMF 20RST binary |JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job? 
packed |JMREDATE Oate reader recognized the JOB card for this job, in the 
form OOY YDDODF where F is the sign? 
+ SMF 20UID _. JMRUSEID User identification (taken from common exit parameter 
area) 


[a2 [2A | cwrzonio[ 2 [einer _[rersurte | ort oto rs From ning of esr 
Sa I a 
| SMF20NAF{ 1 | binary | ACTJNFLD (in JCT) | Number of accounting fieids 


SMF20ACT | variabie JOB statement Accounting fields. Each entry for an accounting field 
contains the length of the fieid (one byte, binary) followed 
—— the fieid (EBCOIC). A zero indicates an omitted field, 
Relocate Section 
SMF 20RLS a a Size of relocate section including this field. | 
+2 RACF Group ID. 
If RACF is not active, this field is set to zero. 
+10 SMF 20RUD EBCDIC | ACEEUSRI RACF User ID. 
lf RACF is not active, this field is set to zero. 


+18 12 SMF20TID ACEETRMP if RACF is not active, this field is set to zero. Also, if 
RACEF is active and the user is not a terminal user then 
this field is set to zero. 


The job name and the time and date that the reader recognized the 
JOB card for this job constitute the job log identification. 


















Chapter 6. SMF Records 6-53 



















6-54 System Management Facilities (SMF) 





Record Type 21 (15) — Error Statistics by Volume 





Record type 21 is written by IGCO009A when a data set on magnetic tape is 

demounted. This record contains statistics for the entire volume during the period 

of time that the volume is mounted regardless of the number of data sets on the 

volume being accessed and regardless of the number of CLOSE macro instructions 
issued. Its length is 62 bytes. 


This record contains the volume serial number, device number, unit type, and 
tape density. It also contains the number of temporary and permanent read and 
write errors, START Subchannel (SSCH) instructions, noise blocks, erase gaps, and 
cleaner actions. 


Notes: 

1. The IFHSTATR utility program formats and prints the error-statistics-by-volume 
(ESV) information in this record. For a detailed description of this utility 
program, see OS/VS2 Utilities. 

2. If amaximum count is reached, it is no longer incremented. A counter at its 
maximum value indicates at least that number since no record is written when the 
counter is full. 

3. A record type 21 is written, in addition to demount time, any time EREP is run or 
when EOD is issued. Therefore, more than one type 21 record may be written for 
each tape that was mounted. The total count will be accurate because the counters 
are cleared when a type 21 record is written. 


The format is: 
































SMF21FLG 1 binary SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
6 VS2 
7 VS1 
Ps [8 | swrarety [1 binary | interat Reserve 
SMF21TME 4 binary SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
A SMF21DTE packed SVC 83 Data record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
}14 | € | SMF21SID EBCDIC| SMCASID System identification (taken from SID parameter) 
18 12 SMF21LGH 2 binary internal Length of rest of record including this field. (This field is | 
always 44.) | 
20 | 14 | smF2ivo.| 6 | eEBcDic| UCBVOLI Volume serial number | 
26 SMF21CA UCBHAN Device number or device address 
SMF21TR | 1 | binary | UCBTR Number of temporary read errors (Non-buffered log) 
SMF21TW | 1 | binary | UCBTW Number of temporary write errors (Non-buffered log) 
22 binary Number of SSCH instructions 
24 SMF21PR binary Number of permanent read errors ae 
24 [binary | cn 
SMF21PW Number of permanent write errors « 


(Continued) 




























Format 


[ort [Nome [teeth 


[sees [Con 















OO 





















43 2B SMF21DEN binary DCBDEN Tape density — 2400 and 3400 series magnetic tape units 
Bits Meaning When Set 
Code 7-Track 9-Track 
| DCBMTDNO 6,7 0 200 BPI N/A 
DCBMTDN1 1,6,7 1 556 BPI N/A 
DCBMTDN2 0,6,7 2 800 BP| 800 BPI 
DCBMTDN3 0,1,6,7 3 N/A 1600 BPI 
DCBMTDN4 0,1,3,6,7 N/A 6250 BPI 












Block size. This field is zero if DCBRECFM indicates 
variable or unblocked records, if you are doing your own 
EXCP processing, or if module |GCOOO9A was entered 


binary DCBBLKS! 
from EREP, VARY, or Allocation. 


binary DCBOFLGS DCBOFLGS 


UCBCTD 


binary UCBCXMBW Number of 4K bytes written 


ae SMF21BLS 2 


46 SMF210FL 1 


47 2F SMF21 TUS 3 


[ao [aa | ara Ta 
[safe | sMrarrwr 


Chapter 6. SMF Records 6-55 








Sala Ae a lat tee as "aa aE a AIST BE Ol aN one 9 ce Sa TT 

















Record Type 22 (16) — Configuration | | co™ 


Record type 22 is written: 
e by ICB2MSG and IEEMB823 after every IPL of the system, 


@ by IEECLEAN when a CONFIG CPU or CONFIG CHP, or CONFIG VF 
operator command is processed, 


e by IEEMPVST or IEEVSTGL when a CONFIG STOR operator command is 
processed, 


e by IGCO012F when a VARY ONLINE,S or VARY OFFLINE;S operator com- 
mand is processed 


This record describes the processor, channel path, storage, or mass storage device 
configuration in effect after the IPL or change. The storage section contains 31-bit 
real storage addresses. Record type 22 also describes the MSS units online at IPL. 
The length of this record is 22 bytes plus the length of the sections in the record. 


Notes: 

1. During system initialization, the Mass Storage Control (MSC) creates a 
configuration record (called Message 92) and puts it in a message buffer. After 
SMF is initialized, ICB2MSG creates the “MSS IPL Configuration section” of 
record type 22 from the Message 92 in the MSC buffer. 

2. By using the VARY ONLINE,S and VARY OFFLINE,S commands, the 
operator can modify the configuration. (The format of these commands is 
described in Operator’s Library: IBM 3850 Mass Storage System (MSS) Under 
OS/VS.) In a record type 22, a “VARY ONLINE,S section” or a “VARY 
OFFLINE;S section” is written for each unit varied by these commands. 


The format is: 


[ores [Weve [leet Formee [ewes [mie 
oe ee ee ee eee 
[a [a | awezases [2 [ny [amar serene ereg 


SMF22FLG SVC 83 System indicator | 
i Bit | Meaning When Set | 
0-4 Reserved | 
5 MVS/XA | 
6 VS$2 | 
7 VS1 


rs_[s_[_swrzanty | 1 [binary [imwerat | ReordyeesSOOSC~—~—SS 


SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer | 
SMF22DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDOF where F is the sign 


| 14 | E | SMF22Si0 ep Ce System identification (taken from SID parameter) 











18 | 12 SMF22iND binary Record creator indicator 
Value Meaning 
IEEMB823 1 IPL 
IEEVCPR/ 2 VARY ONLINE 
IEEVSTGL 
IEEVCPR/ 3 VARY OFFLINE 
ae cee 4 MSS at IPL | 
5 VARY ONLINE,S 
IGC0012F 6 VARY OFFLINE,S 
1GC0012F 7 VARY CHANNEL PATH ONLINE OR OFFLINE 





ee ee ee ee oe ere 


(Continued) 
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CPU Section: 


( [offsets | Name | Length] Format | source | Description 







SMF22CFG 1 binary internal CPU Flags 


Bit Meaning When Set 
0 Vector Facility indicator (VF online) 
1-7 Reserved 


| +1 | | smr22pin | 1 | binary | 1EEVCPR | CPU section identification. (This field is always 1.) 









fs ae SMF 22CPN IEEVCPR CPU model number (taken from CONFIG CPU command 


+5 SMF 22CPA binary | lEECLEAN CPU identifier (taken from CONFIG CPU command or 
default in PSACPUPA) 


Channel Path Section: 
+0 SMF22RV7 1 binary Reserved 


+1 i. | SMF22UID | 4 | binary | internat Channel Path section identification. (This field is always 7.) 


+2 EBCDIC] ICHICPT Array of 256 entries to map each unique CHP 
if 1=CHP, CHP is valid for this installation. If 0, 
SMF 22POW=0 and SMF22PON=0 
If 1=CHP, CHP is owned by this system, and SMF22PFG=1: 
if 0, SMF22PON=0 
lf 1=CHP, CHP is ONLINE, SMF22PFG=1, and 
SMF22POW=1 


Reconfigured Channel Path Section: 
binary Reserved 










: oe 
SMF 22PAR 256 





SMF22PFG | x’80’ 






SMF22POW | x‘40’ 


SMF22PON | x‘20’ 







SMF 22RV8 


+Q 
+1 SMF 22RID 1 binary internal Reconfigured Channel Path section identification. (This 
field is always 8.) 


7 P43 fo SMF 22CHI EBCDIC| internal Array of channel path identifiers 


Storage Section: 
SMF22MFL EBCDIC] |EEMB823 Storage flags 
Bit Meaning When Set. 
0 Real storage frames are interleaved 
1-7. Reserved 


eee SMF22TID | | binary IEEVSTGL Storage section identification. (This field is always 3.) - 
+2 SMF 22PGL binary JEEVSTGL Address of lowest frame in real contiguous storage (taken 
from CONFIG STOR command 
+6 SMF22NPG binary IEEVSTGL Number of frames in real contiguous storage (taken from 
CONFIG STOR command) 


Extended Storage Section: (one contiguous block of online extended storage): 








1 Reserved 


SMF22XID Extended storage identification. (This field is always 9.) 





Beginning extended storage frame (E-frame) address 
in this contiguous block 






+2 +2 SMF22XAD 4 binary jinternal | 
Note: Extended storage is always addressed in frames 


+6 +6 SMF 22XNP 4 binary internal Number of 4K extended storage frames in this 
contiguous block 
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SE Tae TSN TTR ET SEES a 9 hg greene erm rms 











a 


MSS IPL neice Section: 
SMF22RV4 | Reserved 


| , 
| SMF 2211D ‘binary — ICB2MSG MSS IPL configuration section identification. (This field 
! is always 4.) 7 


The following 40 bytes contain the bit pattern of MSS units online at IPL: 
| +2 2 SMF22I0ON 1 binary (See Note 1) ‘Data recording devices (DRDs) of MSF(0) 


SS/D 
200 
201 
202 
203 
204 
205 
206 
207 


binary Data recording devices (DRDs) or MSF(1) 
Bit SS/D 
0 210 
211 
212 
213 
214 
215 
216 
217 


binary Staging Adapters 
SS/D 
800 
; 810 
2 820 
3 830 
8FO 
binary Device recording controls (DRCs) of MSF(O) 
a SSID. 
400 
401 
402 
403 
Device recording controls (DRCs) of MSF (1) 
410 
411 
412 
413 


cid a BC kA A RRR RRRRN 









NOORWN OD 
> 








+10 | 10 28 binary Staging spindles in staging data groups (SDGs) 
SOG Bits SS/Ds 
0 0-7 000-007 
1 0-7 008-00F 
2 0-7 010-017 
3 7 018-01F 
27 OE8-OEF 
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ort [Name [vent | Former 


a Hie scontanenen a Lio ae “co 
Lio ae “co Reserved 


binary MSF indicator 
Bit Meaning When Set 
0 MSF (0) with SSID of 101 
1 MSF (0) with SSID of 102 
2 MSF (1) with SSID of 111 
3 MSF(1) with SSID of 112 
Reserved 


VARY ON Miro ee Section: | 
SM Miro ee a Reserved 
binary a oF VARY ONLINESS section identification. (This field is 
always 5.) 


rez [= [ewrzanva | Yn [fees 


+3 binary | 1GC0012F Subsystem identification of device (taken froin VARY 
_ONLINE,S command) 
VARY OFFLINE a) Section: 
SMF22RV6 binary Reserved 
+1 binary | 1GCO0O12F VARY OFFLINES section identification. (This field is 
always 6.) 


C2 [2 [surzave | 7 [ein | «dene 


+3 binary | 1GC0Q012F Subsystem identification of device (taken from VARY 
OFFLINE,S command) 
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Record Type 23 (17) — SMF Status Record 


Record type 23 is written by IEEMB842 at the interval specified by the STATUS 
keyword. It records SMF statistics collected during the reporting interval. Its 
length is 82 bytes. | 


The format is: 


Offsets | | Name | Length 
SMF23LEN internal 
| SMF23SEG | 


4 SMF23F LG 
SMF23RTY 


SMF 23TME 





Record length’ 


Segment descriptor 


SVC 83 © Header flag byte 





Record type 


internal 


SMF23DTE 4 packed | SVC 83 3 


eee internal 


4 | sMF23POF | 4 internal Offset to product section from start of record, including 


| Time, in hundredths of a second, when the record was 
moved to SMF buffer 


, 10 


Date record was moved to SMF buffer, in the form 
OOYYDDDF, where F is the sign 


EBCDIC] SMCASID System identification (taken from the SID parameter) 


the ROW 
SMF23PLN internal Length of product section _ 
. | SMF23PON 


internal Number of product sections 


internal | Offset to system action from start of record, including the 
ROW 


internal _ Length of system section 


NO NO 
= 


- 
as 


3 


nN 
8 


SMF23SLN 
SMF23SON 


24: | SMF23ROF 


SMF23RLN 
SMF23RON 


binary | ‘internal Offset to SMF statistics section from start of record 
including the ROW 


internal Length of SMF statistics section 
internal Number of SMF statistics sections 


EBCDIC| internal Record version number — ‘01’ 


EBCDIC Product name — ‘SMF’ 


EBCDIC}] SMCASSTS Length of measurement interval 


EBCDIC] CVTRELNO Operating system release level 


SMCABFWT 


0 


binary 


internal Number of system sections 


sie 


” 


Product 


ection: 





SMF23TID 


SMF23RVN 
SMF23PNM 


System Section: 
SMF23INT 


Sub type identification — ‘0’ 





eed 
a ae 











+0 
r6 | [ewrzaats” 


SMF Statistics Section: 





SMF23BFW 


De [_| swr2sero_ 
re |_| swrzasus_ 


Number of buffers written 





SMCABFMF Maximum number of buffers used at one time. 
SMCANMSU Number of times suspended because no buffers are available 


SMF23RCW SMCARCWT | Number of records written 
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Record Type 24 (18) — JES2 Spool Offload 


Record type 24 is written by HASPNET or HASPRDR whenever a job or SYSOUT 
data set is transmitted to or received from an offload data set. JES2 writes one 
type 24 record for each pre-execution job that is transmitted to an offload data set 
or received back to spool. Because one type 24 record is written for each SYSOUT 
data set header that is transmitted or received, multiple type 24 records can be 
expected for each post-execution job. 


This record identifies the name, time and date of each job that has been transmitted 
or received. It also includes specific information about jobs in a record subtype. For 
jobs not yet executed, it reports job-related information such as job class and 
system affinity in the job selection criteria section. For jobs that have already exe- 
cuted, it reports information about SYSOUT data sets such as output group id and 
forms name in the SYSOUT selection criteria section. Whenever record type 24 
contains the job selection criteria section, the length is 206 bytes; when it contains 
the SYSOUT selection criteria section, the length is 227 bytes. Record type 24 
never contains both sections. 


Use IFASMFR to map the JES2 type 24 record. For more information see “Using 
the IFASMFR Macro to Address SMF Record Fields” in Chapter 4. 


This record can be used with the subtype selectivity function. Refer to Chapter 3, 
Part II, for a description of subtype selectivity. 


The format is: 


5 MVS/XA 
6 VS2 





ro] sarzacen | 
em 


2 SMF24SEG 










Meaning When Set 
0 Subsystem name follows standard header 
1 Subtypes utilized 

2-4 Reserved 

1-4 Reserved 












— 

4 SMF24F LG 1 binary SVC 83 System indicator 
J Typ 7 Reserved 
Ps _[swraunry | 1 | vinery | incemat | Reordwpe SSCS 
po Seems [oer [ee 

SMF buffer 
OOY YDDDF where F is the sign 


|e | SMF24S1D EBCDIC | SMCASID System identification (taken from SID parameter) 
SMF24SSI EBCDIC Subsystem identification 


: / 





22 Record subtype 








Value Meaning 
1 Job transmitted 






2 Job received 
3 SYSOUT transmitted 
4 SYSOUT received 






cs 
et 
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SMF24RSV 


ae 


QO 


SMF240GN | 4 | binary | internal Offset to general sections 
SMF24LGN 2 internal General section length 
SMF24NGN | 2 | binary — internal Number of general sections 


> 


4 
SMF240SP internal Offset to job or SYSOUT selection criteria section 

SMF 24LSP | 2 | binary | internal Job or SYSOUT selection criteria section length 
SMF24NSP internal Number of job or SYSOUT selection criteria sections 


Product Section: 
+0 SMF24PVR 2 EBCDIC] internal Record version number 


SMF24PNM ez EBCDIC| internal Product name ‘JES2’ 


eneral Section for Spool Offload Devices: 
+0 SMF24GLN 2 binary internal Length of general section 


+2 SMF24BCF binary internal Buffer continuation flags 


f> Bl BIL dO] Gi] wd NO 
GO}, WT MTN NOTED] =] = 


+] 4+ 
sla 


G) 


NO 


Meaning When Set 


First SMF buffer for job 
Continuation of SMF buffer 
Last SMF buffer for job 


Reserved 


+3 SMF 24EOJ binary internal End of job flags 


Meaning When Set 

Completed job offloaded 

Job completed with skipped data sets 
Uncompleted job offloaded 

Job cancelled by operator 

4 Reserved 


-7 


binary vanes with Number of records transmitted or received 
subtype! 


'The source of this field varies with the subtype value set in SMF24SUB. If the value equals 1, the source is JTWCOUNT; if the value 
equals 2, the source is ROWCNTRR; if the value equals 3, the source is STWCOUNT; if the value equals 4, the source is 
SRWCOUNT. 





+4 SMF24JBN 
+C SMF24J1D 
+14 SMF24CJD 
1C SMF24SYS 4 
+20 SMF24DSN 44 
+4C SMF24CNT 


EBCDIC 
EBCDIC 


+] + 
om as 
oO} 


o 
N 


~ 
NO 
© 
alé 


Ee 
~ 
oO) 


6-62 System Management Facilities (SMF) 











re 


™ 
e 
YS 











( 











Offsets _ 


General Section (continued): 


1 +80 | +50 SMF24TDS XDCTTIME Time offload data set was allocated 


+84 | +54 SMF24DDS binary JCTNONDE Date offload data set was allocated, in the form 
OOYYDDDF where F is the sign 
isthe 5 





=e 
© 
© 


+48 | SMF240RG EBCDIC | XDCTDATE Node of origin 
SMF24TRD JCTNONDE Time on reader where F is the sign 
+64| SMF24DRD JCTRDTON Date on reader, in the form OOYYDDF where F is the sign 


b Selection Criteria Section: 
SMF24LN 2 binary internal 
1 Affinity = any 


1 SMF24JFG binary internal 
2-7 Reserved 


1 EBCDIC] varies with Job class 
subtype 


+C SMF 24JAF 28 EBCDIC | internal Affinity system identification 


SYSOUT Selection Criteria Section: 
+0 +0 SMF24LN2 2 binary | internal Length of SYSOUT section 


+2 SMF24SFG internal SY SOUT flags 


Bi 
0) 
a 
Oo 


4 
a 
(=) 
O 


& 6 
i 


Length of job section 
Job flags 


Meaning When Set 
0 Held job 





+ 


NO 


3 SMF 24JCL 


Meaning When Set 

Held SYSOUT 

Bursted SYSOUT 

Held job 

Incomplete data set 

Multi-destination data set 
5-7 Reserved 





Bo ee a) eerie ecw 
SMF245ND | a | EBCDIC] NDHGNODE | Nodeneme 
smF2asrN | 8 | EBchIC| NOHGAMT 
a 
ee 
a 
La 
ca 
ae 


+ 


+20 | +14 SMF 24FCB 


+24 SMF24FOR 


+32 SMF24FLS 


+36 SMF24PRM 


+44 SMF24UCS 
+ + 
+ 


2The source of this field varies with the subtype value set in SMF24SUB. If the value equals 1, the source is JTIWCOUNT; if the value 
equals 2, the source is ROWCNTRR. 


2 
3 
4 
C 
2 


EBCDIC| NDHGFCB Forms control buffer (FCB) 


N 


B 


4 SMF24WID 
SMF24REC 


+3C SMF24PRY 


6} 
A 


& 
ro) 
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Record Type 25 (19) — JES3 Device Allocation 


Record type 25 is written by IATPURG for each job that completed JES3 
converter/interpreter (C/I) processing. One type 25 record is written for all device 
allocations required for the job, whether or not the job contains DD statements. 
Also, for any job that uses a private catalogue, IATPURG writes a separate type 
25 record for each group of JES3 device allocations used by that job, and 
IATMDBK writes a separate type 25 record for each main device scheduling 
(MDS) dynamic allocation request. 


This record contains allocation-related information such as the number of tape 
and_ disk volumes fetched and mounted, the time and date of the first mount 
message, and the time and date of JES3 device verification. 


Use IFASMER to generate the JES3 record type 25 macro mappiing. For more 
information, see “Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 


SMF25LEN binary. | internal 
SMF 25SEG internal 


4| 4 SMF25FLG SVC 83 


Description 


Record length . 





Segment descriptor 


System indicator 


Bit Meaning When Set 
0-4 Reserved 


MVS/XA 
VS2 
Reserved 





SMF25RTY internal 


| 2 
7 
beg 
Kes ld 


Record type 


Time, in hundredths of a second, record was moved to 


SMF buffer 
SMF25DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
7 OOY YDDDF where F is the sign 
| SMF25SID | EBCDIC| SMCASID System identification (taken from SID parameter) 


SMF25JBN 


SMF25RST 
SMF25RSD 
SMF25U IF 


Descriptor Section: 


EBCDIC]} JSTJBNAM 


binary | JMRENTRY (Set 
by IATISJB) 


packed | JMREDATE (Set 
by IATISJB) 


EBCDIC) JMRUSEID 


Job name? 


> 


Time, in hundredths of a second, reader recognized the 
JOB card for this job? 


Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign? 


User identification (taken from common exit parameter 
area) 


oud 
bb 
om fd 
NO > 


42 2A SMF25IND 2 binary | JST25FG1 Allocation indicators 
Bit Meaning When Set 
0 If O, allocation by user’s DD statements. 
If 1, dynamic allocation. 
1 If 0, non-catalog allocation by JESS. 
If 1, catalog allocation by JES3. 
2 if O, manual allocation by operator. 


If 1, automatic allocation by JES3. (See the MDS 
narameter SETPARAM in OS/VS2 System 


Programming Library: JES3 System 
Programmer’s Guide for more information.) 








Reserved 


1The job name and the time and date that the reader recognized the | (Continued) 
JOB card for this job constitute the job log identification. 
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| Offsets | Name | Length | Format | i eseription 
| Descriptor Section (Continued) | ones: 


44 2C SMF25NT F 4 | binary | JST25NTF Number of |AT5110 GET messages for tape 


volumes issued for the job. 
4 












30 SMF25NDF 


binary | JST25NDF Number of |AT5110 GET messages for disk | 
_ volumes issued for the job. . 


binary | JST25FST (Set Time, in hundredths of a second, fetch processing ended. | 
by |ATMDFE) That is, the time that the first phase of MDS ended. 


(During this phase, messages are issued to inform the 
JST25FSD (Set 
by IATMDFE) 


JST25SST (Set 
by |ATMDDR) 


SMF25FST 


SMF25FSD 


SMF25SST 4 
SMF25SSD 





operator of the volumes required for the job to execute.) 









Date fetch processing ended, in the form 0OOY YDDDF 
where F is the sign 












Ww 
O 


If manual allocation, time *START SETUP operator 
command issued. !f automatic allocation, this field 
contains zeros, 












JST25SSD (Set 
by |ATMDDR) 


lf manual allocation, date *START SETUP operator 
command issued. If automatic allocation, this field 
contains zeros. 


Number of tape volumes mounted by MDS. | | 


SMF25NTM 
Number of disk volumes mounted by MDS. 
j Time, in hundredths of a second, when ali JES3 volume 


[4 | binary 
| SMF25MST 
mount messages have been issued. If no mounts were 


JST25NTM 
JST25NDM 


JST25MST (Set ' 
by IATMDSL) 


















co 


binary 
required, this field equals the time of JES3 allocation. 
packed | JST25MSD (Set | Date when all JES3 volume mount messages have been 
| by I|ATMDSL) issued, in the form OOYYDDDF where F is the sign. If | 
no mounts were required, this field equals the date of 
| JES3 allocation. 
SMF25VVT binary | JST25VVT (Set | Time, in hundredths of a second, of JES3 device 
by IATMDVE) verification 
SMF25VVD| 4 | packed | JST25VVD (Set | Date of JES3 device verification, in the form 
by IATMDVE) OOYYDDDF where F is the sign 
5C . SMF25NMV binary | JST25NMV Number of Mass Storage Volume requests allocated 
. by MDS for the job. 














wis 
'@) 
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_ Record Type 26 (1A) — JES2 Job Purge 


Record type 26 is written by HASPMISC at job purge after all SYSOUT for the job 
is processed. This record identifies the job by job log identification, JES2-assigned 
job number and programmer’s name. 


Record type 26 also contains operating information such as, message class, job class, 
JES2 job selection priority, JES2 logical input device name, output lines, output 
punched cards, print/punch route codes, and start and stop times for the reader, 
converter, execution processor, and output processor. Its length is 236 bytes plus 80 


bytes for the network section, 22 bytes for the routing section and 18 bytes for the 
print section. 


Use IFASMER to generate the JES2 record type 26 macro mapping. For more 


information, see “Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 


| sets Length | Format | Source 

| SMF26LEN | internal Record length - 
internal Segment descriptor 

SMF26FLG 1 binary | SVC 83 | System indicator 


Bit Meaning When Set 
0-4 Reserved 


i 
me 


Description 


oa 


— 





aS 


| 5 MVS/XA 
| 6 VS2 | 
7 Reserved 


binary | SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 


packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDODF where F is the sign 


EBCDIC| SMCASID System identification (taken from SID parameter) 


A SMF26DTE 


=> | aod 
oO; 


| SMF26TME C* | 


[swezesio [4 







1 


EBCDIC| JCTJMRJN Job name 


4 binary JCTRDRON Time, in hundredths of a second, reader recognized the 


SMF26RST 
| JOB card for this job 


| Date reader recognized the JOB card for this job, in the 


SMF26RSD packed 
form OOY YDDODF where F is the sign 


SMF26RTY binary | internal Record type 


JCTRDTON 


* 
& 


8 
aS 

N 
OR 


| | area) 
SMF26RSV 
SMF26SBS 


SMF26IND | 2. |binary | internal Entry type indicator: 


NO 
8 


binary Reserved 


Subsystem identification — X'0002’ signifies JES2 


SMF26UIF EBCDIC| JCTUSEID User identification (taken from common exit parameter 


binary ‘internal 


48 





Ww 
© 


Bit (Meaning When Set 

0 Descriptor section present 
1 Events section present 

2 Acutals section present 

3 Reserved 

4 Routing section present 

5 Print section present 

6 JES2 Spool use section 

7 


-15 Reserved 
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[96_|eo | smr2epev| | escpic | JcTINDEV 














Source | Description 


Offs [Nemo | Length [Format 

Descriptor Section: 

50 | 32 SMF26LN1 binary | internal Length of descriptor section, including this field 
7 


SMF26RV1 binary | ___——*dt~Reserved _ 


binary | JCTJOBFL Job information indicator 
Bit Meaning When Set 
0 Background batch job 
1 Foreground TSO user 
2 System task 
3 No journal option 
4 No output option 
5 TYPRUN=SCAN was specified 
6 TYPRUN=COPY was specified 
7 7 RESTART = Y was specified 


SMF26INF SCTJBOPT | Job information indicator 


3 


Bit Meaning When Set 

0 /* PRIORITY card present or keyword 
‘PRTY =’ was specified on JOB card 
/* SETUP card(s) present 


TYPRUN=HOLD was specified 
No job log option 
Execution batching 










Job was entered on internal reader 
Job was canceled by the operator 

| 56 | SMF26JNM | 4  |EBCDIC|JCTJOBID +4 JES2-assigned job number 

3C SMF26JID EBCDIC | JCTJOBID Job identification in the form xxxOyyyy where yyyy is the 

JOB — for normal JES2 job 
STC — for started task control job 
TSU — for TSO job 

|s8 [58 | sSmF26msG| 1 | EBCDIC|JCTMCLAS Message class (taken from JOB card) 

'a9. {59 | smr2ects | 1 | EBCDIC|JCTIJCLAS Job class (taken from JOB card) 

}90 | 5A | smF26xP! | 1 [binary |JCTIPRIO JES2 job selection priority when the job was initially read 

ff a se | Te 

|94 | se | smF26e.oc| 2  |binary |JCTROUTE Input route code? 


Job was rerun by JES2 
JES2-assigned job number and xxx is: 
| SMF26NAM| 20 _ EBCDIC | JCTPNAME Programmer’s name (taken from JOB card) 
91 | 5B | SMF26XPS | 4 [binary JCTPRIO JES2 job selection priority when the job was selected 
JES2 logical input device name 










| 104/68 | SMF26ACT| 4 | EBCDIC| JCTACCTN 
108 |6c | SMF26ROM| 4 | EBCDIC]JCTROOMN 
raz |70_| smrzextw | 4 [binary —|JCTETIME 
120 [78 | SMF26EPU | JCTESTPU 


SMF26ERM EBCDIC | JCTEORMS 


1The job name and the time and date that the reader recognized the JOB card for this. (Continued) 
job constitute the job log identification. 


Programmer’s accounting number 
Programmer's room number 


Estimated execution time, in seconds2 






Estimated output lines 










Estimated output punched cards 

Output form number. If the source field contains four or 
fewer characters, SMF26FRM is set. Otherwise, this field is 
set to blanks, and the contents of the source field appears 
only in SMF26EFM, described under the Routing Section 
jater in this record. 





2These fields are JES2-defined subfields from the accounting information field in the JOB card or default values assigned for 
this job or from /*JOBPARM, JES2 control card. 


3These fields are defined as follows: X‘0100’ indicates local routing; X‘nnrr’ is remote routing; and X‘OOnn’ indicates special 
local routing. If more than 255 remotes are specified for the system, this field is set to zero. The routing section has the 
expanded route codes that should be used if these fields are zero. See the Routing Section described later in this record, 
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ete ao™ 
fsets Name Format Source Description in 


—_= 
NO 
31S 


~ 
ie) 
© 


SMF26PUR 
SMF26PDD 


am | = 
w | ow 
AlN 
3] 8) 8] 8/8 
ee) nN 
wn 
s 
m1 
N 
ep) 
U0 
ws) 
DD 


_ 
wo 
o 









Events Section: 
144 | 90 SMF26LN2 binary | internal Length of events section, including this field 
_ SMF26RV2 binary Reserved 





” 


MF 26RPT 
SMF26RPD 


4 JCTRDROF 


JCTRDTOF 


binary 


Reader stop time, in hundredths of a second 


‘Reader stop date, in the form OOYYDDDF where F is 
the sign 


Converter start time, in hundredths of a second 


packed 


SMF26CST binary | JCTCNVON 


JCTCDTON 











ro] 


Converter start date, in the form OOY YDDDF where F 
is the sign 


Converter stop time, in hundredths of a second 


Converter stop date, in the form OOYYDDDF where F 
is the sign 


c/ 2 
=] re) 
a x 
P @ 
< o. 


SMF 26CPT 
SMF26CPD 


JCTCNVOF 


8 packed | JCTCDTOF 


binary | JCTXEQON Execution processor start time, in hundredths of a second 


| 4 packed | JCTXDTON Execution processor start date, in the form OOY YDDODF 
: where F is the sign 


JCTXEQOF Execution processor stop ti me, in hundredths of a second 


JCTXDTOF Execution processor stop date, in the form OOY YDDDF 
where F is the sign 


binary | JCTOUTON Output processor start time, in hundredths of a second = a 


packed | JCTODTON Output processor start date, in the form OOYYDDDF ed 
where F is the sign 


binary | JCTOUTOF Output processor stop time, in hundredths of a second 


packed | JCTODTOF Output processor stop date, in the form OOY YDDDF 
where F is the sign — 
Actuals Section: 
204. | CC | . SMF26LN3 binary internal Length of actuals section, including this field 


E | smezerve inary | Reseed 









© 


” 


MF26XST 
SMF26XSD 


C 


| 2 
~J 
NO 


” 


MF26XPT 


8 MF26XPD 4 packed 


~ 
® 
3 
< 


= 
oO 
o 
n” 


MF260ST 


_ 
© 
nN 





SMF 260PT 
SMF260PD 


; aa 
~ 
| a wo > > 
” 


SMF26ICD 4 binary | JCTCARDS Number of input cards for job. This field includes JCL and 
SYSIN cards. 


2These fields are JES2-defined subfields from the accounting information field in the JOB card or default values assigned for 
this job or from /*JOBPARM, JES2 control card. 


SMF26CID 
SMF26X1ID 
SMF260I1D 


) 2) 
© 
HE 


3These fields are defined as follows: X‘0100’ indicates local routing; X‘nnrr’ is remote routing; and X‘OOnn’ indicates special 
local routing. If more than 255 remotes are specified for the system, this field is set to zero. The routing section has the 
expanded route codes that should be used if these fields are zero. See the Routing Section described later in this record. 
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( - Offset 


Network Section: 


+0 SMF 26LN4 binary internal Length of network section including this field 

+2 sMF26RVS | 2 |binary | = | _—Reserved 

| SMF26NID | 4 | EBCDIC |JCTNJSID Job transmitter system identifier 

(+8 [+8 | SMF26NST | 4 |binary |[SVC11 | Job transmitter start time 

| }+12 [+c | SMF26NSD | 4 |packed |SVC11 | Job transmitter start date 

}+16 | +10 | SMF26NPT | 4 |binary [SVC11 | Job transmitter stop time 
[2a [ve | surzenac | [escoic [actuacet | Nework eccounting number 
[ese [20 | swr2enua [8 [escdic [sctnouo | Original job Wenifenion 
[a0 [-28 | -surzenov | [eeco1c[DcTEVN | dob wansmiter devierame 
[aa [s0 | smrzenon | 6 | eecoic|Niwooe | Oriealnode name 
[ose [a8 | swrzonxn | 8 [e80b1C | NITNODE | _Evecution nodeneme 
rea [oa0 | swrzennm [8 [ESCDIC|NITNODE | Newtnodename 


40 
48 SMF26NLN 8 EBCDIC | NITNODE Last node name 
Routing Section: 
SMF26LN5 2 binary internal Length of routing section including this field 


+0 +0 
SMF26PRD JCTPROUT Default print route code | 


| SMF26PUD | 4 | binary | JCTPUOUT Default punch route code 
| a Print Section: 
| ( SMF26LN6 2 binary internal Length of print section including this field 


+0 +0 
SMF26EBT | 4 | binary JCTESTBY Estimated SYSOUT byte count 
SMF26XBT | 4 | binary | JCTBYTES Actual SYSOUT byte count 


+18 | +12 SMF26EFM EBCDIC | JCTFORMS Output form number. This field is set regardless of the 
number of characters in the forms field. 


1 These fields are defined as follows: X‘00010000’ indicates local routing; X’nnrrnnnn’ indicates remote routing; and 
X'0000nnnn’ indicates special local routing. This field is always set regardless of the number of remotes specified for 
the system. 


+ + 
& oO 














2For page mode data sets, JES2 updates the page count when it encounters a “begin page’ indicator in the data stream header. 
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Record Type 26 (1A) — JES3 Job Purge 


Record type 26 is written by IATPURG at job purge after all SYSOUT for the job 
is processed. This record identifies the job by job log identification, JES3-assigned 
job number, and programmer’s name. 


Record type 26 also contains operating information such as message class, job 
class, JES3 job selection priority, JES3 logical input device name, execution time, 
output lines, output punched cards, deadline schedule type, deadline schedule time 
and date, and the start and stop times and dates for the reader, the converter, the 
execution processor, and the output processor. Its length is 418 bytes. 


Note: The format of all fields in this record are binary unless data is entered 
in the field. 


The format is: 


SMF26FLG binary SVC 83 System indicator 
Bit Meaning When Set 
0-5 Reserved 
6 VS2 
7 Reserved 
























SMF26RTY Record type 


6 SMF26TME binary SVC 83 Time, in hundredths of a second, record was moved to 
: SMF buffer 
A SMF26DTE 


SMF26S1D 
SMF26JBN 


SMF26RST 


packed SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 

EBCDIC | JMRCPUID System identification (taken from SID parameter) 

EBCDIC | IATISJB Job name? (taken from job’s RESQ) 


binary |ATXTOD macro -| Time, in hundredths of a second, reader recognized the 
(Set by IATISJB) | JOB card for this job? | 
packed 1ATXTOD macro Date reader recognized the JOB card for this job, in the 
(Set by IATISJB) | form OOYYDDDF where F is the sign? . 
SMF 26U IF EBCDIC | JMRUSEID User identification (taken from common exit parameter 
(Set by JIATPURG)| area) 


SMF26RSD 





SMF26SBS Subsystem identification — X‘0008' signifies JES3 


| 7 


1The job name and the time and date that the reader recognized the JOB (Continued) 
card for this job constitute the job log identification. 






Entry type indicator: 





Bit | Meaning when set 

0-4 Descriptor section present 
1 Events section present 

2 Actuals section present 
3-4 Reserved 

5 Print section present 

6-15 


Po 
18.9) 


Reserved 
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ww Y 











gs 
NO 


Le) 








Length 


Descriptor Section: 
50 32 SMF26LN1 2 
34 SMF26RV1 2 
SMF26IN3 


| source | eseription 


binary Length of descriptor section, including this field 


binary | Reserved 


binary Job information indicator 
Bit Meaning When Set 


Dependent job (//* NET card processed) 
1 Deadline scheduling (DEADLINE parameter was 
specified on //* MAIN card) 


























IATISNT 
IATISDL 





















IATPURG 2 Deadline job met deadline 

IATISPR 3 Process job (//* PROCESS card processed) 
1ATNJDJ 4 Job left system via NJP (network job processing) 
IATNJDJ 5 Job entered system via NJP 

IATDJOT 6 Job left system via DJ (dump job) 

IATDJIN 7 Job entered system via DJ 


37 SMF 26INF binary Job information indicator 


Bit Meaning When Set 


IATISJB 0 Job priority (taken from PRT Y= parameter on 
JOB card) 
IATIIDR 1 Job processed by preexec setup 





IATISJB 2 TYPRUN=HOLD was specified on JOB card 


3-4 Reserved 





IATISJB 5 Job was entered on internal reader 

IATMSIN for ASP, | 6 Job was rerun on an ASP main reader or a JES3 
or |ATMSMS for reader 
JES3 

IATPURG 7 Job was canceled by the operator 


SMF26JNM 


EBCDIC | IATISJB or JES3-assigned job number (taken from job’s RESQ) 
IATPURG 


EBCDIC | 1ATISJB Job identification in the form xxxOyyyy where yyyy is the 
JES3-assigned job number and xxx is: 
JOB — for normal JES3 job 
STC — for started task control job 
TSU — for TSO job 


EBCDIC | IATIIPR Programmer’s name (taken from JOB card) 


EBCDIC | !tATISJB Message class (taken from MSGCLASS= parameter on 
JOB card) ) 


EBCDIC | IATISJB Job class (taken from CLASS= parameter on JOB card). 


3C SMF26JID 





SMF26NAM 
SMF26MSG 


20 


5 ~S 
pS 





SMF26CLS 





This field is blank if the default is used or if a valid 
CLASS= parameter is specified on the //* MAIN card. 
See offset 172. 
















SMF26XPI binary IATISJB if JES3 job selection priority when the job was initially 
PRTY= parameter | read (taken from: 1) PRTY= parameter on JOB card, 
or IATISEN 2) class default priority from main processor job class 


table, or 3) default priority from TVT) 


SMF26XPS binary IATMSIN for JES3 job selection priority when the job was selected 
ASP, |ATMSMS (taken from job’s RESQ) 


for JES3 


EBCDIC JES3 logical input device name, or user identification if 
IATNJDJ if NJP © TSO job, or line name if NJP job 


binary IATISMN if Estimated output lines (taken from LINES= parameter on 
LINES= parameter | //* MAIN card or default (JOBLINES field in TVT times 
or IATISJB if 1000) } 

default 





o 


Cc SMF26RV8 


SMF26DEV 





SMF26RVA 
SMF26XTM 
~SMF26ELN 


0 
4 





(Continued) 
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IATISMN if || Estimated output punched cards (taken from CARDS= 


binary 
CARDS= parameter parameter on //* MAIN card or default (JOBCARDS 
or |ATISJB if field in TVT times 100)) 

default 


| EBCDIC IATISDL Deadline schedule type (taken from DEADLINE parameter 
on //* MAIN card). Valid types are A-Z and 0-9. 
EBCDIC!] IATISJB JES3 logical input device group name 


EBCDIC | IATISMN if Procedure DDNAME used for JCL conversion (taken from 
PROC= parameter PROC= parameter on //* MAIN card or default 

or |ATISJB if (IATPLBST)) 

default 


EBCDIC IATNJDJ Name of system to which job is sent via NJP 


EBCDIC | JATNJDJ Name of local NJP terminal supplied by the JES3 
initialization deck 
SMF26NET | EBCDIC IATISNT Identification of dependent job net to which this job 
belongs (taken from //* NET card) 
SMF26DTM binary IATISDL Deadline schedule time, in hundredths of a second (taken 
from DEADLINE parameter on //* MAIN card) 
172 | AC SMF26DDT packed IATISDL Deadline schedule date, in the form OOY YDDDF where F 
| is the sign (taken from DEADLINE parameter on 
//* MAIN card) 


176 | BO SMF26CLN ai EBCDIC | IATISMN if Job class (taken from CLASS= parameter on //* MAIN 









SMF26DTY | 





fal Bae 
CIE a oe. 
28 | 


As 





















SMF26NJI 








or |ATISJB 
if default 






CLASS= parameter | card if valid, or the default (JSSBATCH)) 
Events eeeene- 





SM F26LN2 


| 188 SMF26RPT 
192 i SME26RPD 
| SMF26CST 


ili a 


208 | Do | sMmF26cPD 
ale SMF26XST 
aid SMF26XSD 


| 220 | DC SMF 26XPT 


[binary internal Length of events section, including this field 


|ATXTOD macro Reader stop time, in hundredths of a second. This field is 
(Set by IATISEN) filled in during JOB card processing. 


|ATXTOD macro | Reader stop date in the form OOY YDDDF where F is 
(Set by I|ATISEN) | thesign. This field is filled in during JOB card processing. 


| binary | WATXTOD macro 
(Set by [ATIIDR) 


packed CVTDATE 
(Set by |ATIIDR) 







binary 














sacked 


By 









Converter start time, in hundredths of a second. This field 
is filled in following the JES3 LOGIN of the interpreter job. | 


Converter start date, in the form OCY YDDDF where F 
is the sign. This field is filled in following the JES3 LOGIN 


of the interpreter job. 
!ATXTOD macro 


Converter stop time, in hundredths of a second. This field 
(Set by JATIIDR) is filled in at the end’ of the interpreter function. 


CVTDATE Converter stop date, in the formOCYYDDDF where F 
(Set by IATIIDR) is the sign. This field is filled in at the end of the interpreter 
function. 





















binary 


packed 


1!ATXTOD macro Execution processor start time, in hundredths of a second. 
(Set by I|ATMSMS) | This field is filled in when the job is scheduled to run ona 
JES3 local or global processor. 


| binary 






CVTDATE (Set by 
IATMSMS) 


Execution processor start date, in the form OCYYDDDF 
where F is the sign. This field is filled in when the job is. 
scheduled to run on a JES3 local or global processor. 


packed 





binary IATXTOD macro Execution processor stop time, in hundredths of a 
(Set by IATMSMS) | second. This field is filled in when the job is terminated 


on a JES3 loca! cr globa! processor. 





1!ATXTOD macro Execution processor stop date, in the form OOY YDDDF 
(Set by [ATMSMS) | where F is the sign. This field is filled in when the job is 
terminated ona JES3 local or global processor. 


~ SMF26XPD 


(Continued) 
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( 





















[ore [term [ume] Former [Source 


Events Section: (Continued) 
SMF260ST 


meyer “ 


Description 










Output processor start time, in hundredths of a second. 
This fieid is filled in when output service starts 
to process the job’s data sets. 


1ATXTOD macro 
(Set by |ATOSDR) 


binary 












Output processor start date, in the form OOY YDDODF 
where F is the sign. This field is filled in when output 
service starts to process the job’s data sets. 


IATXTOD macro 
(Set by |ATOSDR) 


















1!ATXTOD macro 
(Set by IATOSWS) 


Output processor stop time, in hundredths of a second. 
This field is filled in: 1) when an RQ is removed from the 
writer queue, 2) when all output OSEs are deleted/ 
released, and 3) when a request from the SYSOUT 
interface is processed. 













Output processor stop date, in the form 0OOY YODDF where 
F is the sign. This field is filled in: 1) when an RQ is 
removed from the writer queue, 2) when all output OSEs 


ne _ a 7 
SMF260PD packed 

| are deleted/released, and 3) when a request from the 

| SYSOUT interface is processed. 


Actuals Section: 
244 | F4 SM F26LN3 binary | 


IATXTOD macro 
(Set by [|ATOSWS) 












Length of actuals section, including this field 


Reserved 





Number of input cards for job. This field includes JCL 
and SYSIN cards. 


| Number of output lines generated to spool. This field is 


filled in when the job is terminated on a JES3 local or 


252} FC SMF 26XLN | binary \ATMSMS 
| global processor. 
256 SMF26XPU | |IATMSMS Number of punched cards generated to spool. This field is 
| filled in when the job is terminated on a JES3 local or 
global processor. 
104 EBCDIC | TVTCPUID Input processor system (CPU) identification 
(Set by |ATISJB) | 


264 | 108. SMF 26CID EBCDIC | TVTCPUID Conversion processor system (CPU) identification 
(Set by IATIIDR) 


10C| SMF26XID EBCDIC | TVTCPUID | Execution processor system (CPU) identification 
(Set by |ATMSMS) 


bia band Deceit Bel oes Ce Output processor system (CPU) identification 
: oe (Set by |ATOSDR) 

| 276 | 114] SMF26aF | 42 [eBcdic{] | Reserved for job accounting fields | : 
Pera[tae | Nieummio [8 | €8cDI6 | inernat | Neworking aan WEIMAR 
| 326|146 | NJEJMRLN | 2 | binary | NJEJMRSZ | ; Length of data that follows including this field | 
| 338/152] NJExcom | 8 EBCDIC | NJHGXEQN | Execution node name 

| 366/16€ | NvEUSRID | 8 | EBCDIC Origin or notify user identification 

| 3741176 | NJEAccCT | 8 EBCDIC Networking account number | 

| 382}17E | NJEDEPT | 8 | EBCDIC Programmer's department number 

| 390 | 186 | NJEBLDG | 8 | EBCDIC | NJHGBLDOG | Progremmer’s building number 

SS ee Execution user identifier 
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[rier [Nome [eos [Format [Sous [eins 


Print Section: 
SMF26LNG binary Length of print section including this field 


le SMF26EBT 4 | binary TVTMAXB Estimated SYSOUT byte count 
EEE. SMF26X BT ts JSQACTB | Actual SYSOUT byte count 


ores == — 












Actuai page count. For page mode data sets, JES3 updates 
the page count when it encounters a ‘’begin page’ indicator 
in the data stream header. 











_ 6-74 System Management Facilities (SMF) 











( | Record Type 30 (1E) — Common Address Space Work Record 


Record type 30 is written by IEFTB721 at normal or abnormal termination of a 
batch job or step, a TSO session, or a started task, by IEEMB836 at the expiration 
of an accounting interval if INTERVAL is specified in SMFPRMxx, by IEFSMFIE 
at the start of a job or at the start of the first step after a warm start, or by 
IFAEASI at the expiration of an accounting interval for a system address’space. 


The type 30 record can be used with the subtype selectivity function. Refer to 
Chapter 3, Part II, for a description of subtype selectivity. 


The type 30 record consolidates the data in the type 4, 5, 20, 34, 35, and 40 
records. The record identifies the job and job step by the job log identification, 
step name, number of the step within the job, user identification, program name, 
performance group number and JES job number. If accounting numbers (which 
can be alphameric) are specified in the JOB or EXEC statements, they are included. 
For job start records (subtype 1) and job termination records (subtype 5), 
accounting numbers are taken from the job card. For all other subtypes, the 
accounting numbers are taken from the EXEC card. (The subtype is identified in 
offset 0 of the subsystem section). In addition, the interval record (subtype 2) and 
the step termination record (subtype 3), contain data that represents the change 
since the last interval record or the start of the step. 


The record also contains operation information such as the job and step start 
Po, and end times, step CPU time, step termination status, number of records in 
( DD DATA and DD * data sets for the step and job, device allocation start time, 
problem program start time, and storage protect key. The record also contains the 
number of page-ins, page-outs, swap-ins, and swap-outs for both VIO and non-VIO 
data sets. The record contains an entry for each data set that was defined by a DD 
statement or dynamic allocation. Each entry lists the device class, unit type, 
device number, EXCP count, and device connect time for the data set. 


The length of record type 30 is variable. 


Because system address spaces do not use full function start, the subtype 6 
record is incomplete; that is, only certain fields in each section are valid. All 
unused fields are set to zero. The valid fields in each section are: 


Section Offset Field Name 

Header and Defining Section 0 through 104 All fields 

Subsystem Section +0 SMF30TYP 
+2 SMF30RSI 
+4 SMF30RVN 
+6 SMF30PMN 
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Section 
Identification 
Section 


Storage and Paging 
Section 


Performance Section 


I/O Activity Section 


Processor Accounting 
Section 


The subtype 6 records are written only at the expiration of an interval; the values 
are cumulative and indicate data collected since the initialization of the address 
space. If a system address space later goes through full function start, data is not 
reported for the period between the expiration of the last interval and the time 





Offset. 


+0 
+44 


+8 

+12 
+16 
+20 
+24 
+28 
+32 
+36 
+40 
+44 
+48 
+52 
+56 
+60 
+64 


+0 

+4 

+8 
+12 
+16 
+20 
+28 
+32 


+4 


+0 
+4 
+8 





Field Name 


SMF30JBN 
SMF30PGN 


SMF30PGI 
SMF30PGO 
SMF30REC 
SMF30NSW 
SMF30PSI 
SMF30PSO 
SMF30VPI 
SMF30VPO 
SMF30VPR 
SMF30CPI 
SMF30CPR 
SMF30LPI 
SMF30LPR 
SMF30PST 
SMF30PSC 


SMF30SRV 
SMF30CSU 
SMF30SRB 
SMF3010 

SMF30MSO 
SMF30TAT 
SMF30RES 
SMF30TRS 


SMF30TEP 


SMF30PTY 
SMF30CPT 
SMF30CPS 


‘that the address space goes through full function start. 


For more information on system address spaces and full function start, refer to 


Initialization and Tuning. 


Because some of the information necessary to complete a field is not always 
available when a type 30 record is written, some fields might be empty. For 
example, the SMF30AST, SMF30PPS, SMF30SIT, and SMF30STD fields are not 
filled in for a job start record (subtype 1). 
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Notes: 


l. 


Data sets are recorded in the order of the DD statements; they are not identified 
by name. However, the ddname is included in the record. (A user written 
IEFUJV exit routine can record this order as each statement is validated). For 
concatenated DD statements, the ddname is the same on each entry. 


. For more information on EXCP count and CPU time, see Chapters 8 and 9, 


respectively. 


. Duplicate EXCP entries are consolidated. That is, if the ddname, device class, 


unit type, channel address, and unit address are the same for the entries in the 
TCTTIOT, the EXCP count is accumulated in one entry in the type 30 record. 


. If a section is not included in the record, the “number of” entry is zero. For 


example, subtype 1 does not have a completion segment, and SMF30TON is 
set to zero to indicate this. 


. If the IEFUSI exit changes the size of the private area, a flag is set in SMF30SFL 


in the paging and storage section. 


. The maximum length of the type 30 record is 32,756 bytes. If the number of 


DD statments is such that the length would exceed the maximum length, one 

or more additional type 30 records are produced. The additional records contain 
only the header, self-defining subsystem, identification, and EXCP sections. When 
examining a type 30 record, SMF30EON indicates the number of EXCP section 

in the record you are examining; SMF30EOR field indicates the number of EXCP 
sections in all subsequent type 30 records for the job. The IEFACTRT exit will 
be called for each type 30 record written to the SMF data set. 
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The format is: 


SMF30LEN binary _| internal 
SMF30SEG | — | internal 


SMF30FLG i SVC 83 


2 
2 
SMF30RTY 1 
4 
4 


Record length 





NO | oO 


Segment descriptor 


System indicator 

Bit (Meaning When 

0 Subsystem identification follows system identification 
1 Subtypes utilized 


Reserved 
MVS/XA 
VS2 
VS1 


Record type 






SMF30TME CM wad SVC 83 


Time, in hundredths of a second, record was moved to. 
SMF buffer 

Date record was moved to SMF buffer, in the form 
OOYYDDDF, where F is the sign. For a TSO session, 
this date is the logoff date. 


System Identification 


EBCDIC | OUCBSUBN Subsystem identifier 
internal Record subtype 


internal Offset to subsystem section from start of record, including 


| the RDW 


a 
ae 
ee 
ae 
a 
ae cal 
2 [inary — 
ee 
Ls 
ae 


A | SMF30DTE 


_ 


EBCDIC | SMCASID 


SMF 30STP 
MF 30SOF 


Length of subsystem section 


nin; a 
=| 
nn} om 
W| & 
Oo} 9° 
AIH 
oltm 
zi2z 





Number of subsystem sections 


Offset to identification section from start of record, 
_ including the ROW 

Length of identification section 

Number of identification sections 


Offset to I/O activity section from start of record, 
including the ROW 
Length of 1/O activity section 


Number of 1/O activity sections 


” 


20 MF30IOF 


” 


MF3OILN 


C 


MF30TOF 


Offset to completion section from start of record, 
including the ROW 





4, 


Q 


” 


MF3OTIN 
MF30TON 
MF30COF 


Length of completion section 
Number of completion sections 


binary Offset to processor section from start of record, 
including the ROW 
MFSOCLN Length of processor section 
MF30CON internal Number of processor sections 


MF3SO0AOF 4 Offset to accounting section from start of record, 


MF30ALN 
SMF30AON 
SMF30ROF 


a1” 


| alelsy elalel elels] slslel obs als 


Cc 


ie) 
2) 


ANIM nln 
sic =iz 
nin nin 
Ww] w Wl] Ww 
Oo1|o oO1o 
cic ClO 
oO}; rm O;|s> 
zZi2 nN 


” 


” 






40 


including the RDW 


internal Length of accounting section 


Number of accounting sections 7 


Offset to storage section from start of record, including 
the RDW 

Length of storage section 

Number of storage sections 


50 | SMF3OPOF 4 binary | internal Offset to performance section from start of record, 


| including the ROW 
SMF3OPLN [ 2 [binary | Length of performance section 
SMF30PON | 2 | binary | 
SMF3000F ia binary 
a [se [ swrscoun | 2 [binary — 
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4C SMF30R LN 


tow ~~] w 


ym 


© 
© 


on 


Number of performance sections 


88 Offset to operator section from start of record, 


including the ROW 
Length of operator section 
































| 94 | 5E. | SMF3000N |binary — internal Number of operator sections 


Offset to EXCP section from start of record, 


binary 
mae including the ROW 


SMF30ELN 2 internal Length of EXCP section 


SMF30EON Number of EXCP séctions in this record a 
Number of EXCP sections in subsequent records 
Sub type identification 


SMF30EOR 
1 = Job start | 


SMF30TYP binary 
2 = Interval 


3 = Step termination? 
4 = Step total 
{+2 [| SMF30rs1 Farad 
ae internal 


96 | 60 SMF30EOF 





N 







Record version number — ‘02’ 


Subsystem or product name 


o> 


5 = Job termination 


6 = System address space — 
Identification Section: 
| +0 SMF30JBN 8 EBCDIC | JMRJOB 


Reserved 







: 2 
Job or session name 










+8 SMF30PGM | EBCDIC SCTPGMNM Program name (taken from PGM= parameter on EXEC | 
| card). If a backward reference was used (SCTSTYPE equals 
| X‘80’)s then this field contains PGM=*.DD. | 
|} +16| | SMF30STM 8 | EBCDIC| SCTSNAME Step name (taken from name on EXEC card) _ | 
—— | SMF3OQUIF Le EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area) | 
+32| | SMF30JNM | 8 _ | EBCDIC| SSIBJBID JES job identifier oo 
+40] | SMF30STN | 2 [binary | LCTSNUMB Step number (first step = 1, etc.) _ | 
| +42] | SMF30CLS Et EBCDIC | JCTJCSMF Job class. Blank for TSO session or started tasks | 
a ee a 
| 444 | SMF30PGN OUCBNPG Job performance group number 
+46| | smFsoupT | 2 | binary | JCTIPRTY JES input priority? a 
+48| | smFzoast | 4 [binary | TCTAST Device allocation start time a 
| +52] | smrsopps | 4 | binary | TCTPPST Problem program start time, in hundredths of asecond 
+56 - SMF30SIT po ieee: JCTJMRSS Time, in hundredths of a second, initiator selected this step | 
or job 
+60 SMF30STD packed | JCTSSD Date initiator selected this step, in the form OOY YDDDF 
! where F is the sign 
+64 SMF30RST | binary JMRENTRY Time, in hundredths of a second, reader recognized the 
| 7 JOB card for this job . 
+68 SMF3O0RSD packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign 
+72 SMFSORET | binary |JMRDRSTP Time, in hundredths of a second, reader recognized the end 
of the job or started task (reader stop time). For TSO, this 
| | is the logon enqueue time, 
+76 SMF30RED packed | JMRDRSTP +4 | Date, in the form OOYYDDDF, where F is the sign, reader 
recognized the end of the batch job or started task (reader: 
stop date). For TSO, it is the logon enqueue date. 


Step termination records are produced only when interval accounting is specified. The data represents the activity since 
- the last interval record was written. 


*The job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 


31f no value is specified for the PRTY parameter on the JOB card, this field contains: 
e For JES3, the default priority specified on the JES3 STANDARDS initialization card 
e For JES2, a zero. 
Note that JES2 does not use the priority value reported in this field. (The JES2 job selection 
priority is requested via the JES2 PRIORITY control statement.) 
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identification Section elie 
+80 |+50]; SMF30USR EBCDIC |ACTPRGNM | Programmers name 
+100|+64] SMF30GRP EBCDIC JACEEGRPN _—'|_ RACF group ID 
| +108]+6c} SMF30RUD EBCDIC |ACEEUSRI RACF user 1D 
| +116/+74| SME30TID EBCDIC JACEETRMF RACE terminal 1D 
] | 0 = RACF is not active; user is not a terminal user. 






1/0 Activity Section: 
SMF30INP 





“Number of card-image records in DD DATA and DD* data 
sets read by the reader for the map. This field is not set for 
subtypes 2 and 3. 





Total blocks transferred (accumulated EXCP counts) 


Ta [44 | -SMF30TEP 
SMF30TPT 
az 


Number of TPUTS for a TSO session4 
CTLIN Number of TGETS for a TSO session4 


binary Risader device class 
-— for TSO sessions or started tasks 
11 SMF30RDT binary ie device type 
— for TSO sessions or started tasks 
+18 +12 SMF30TCN binary ASCBDCTI Total device connect time for this address space 
—TCTDCTI 


+161 SMF30MFL Flag word 


+28 C SMF30TRR | 
‘Step termination records are produced only when interval accounting is specified. The data represents 
the activity since the last interval record was written. 


SMF30TGT. 
+16 | +10] SMF30RDR 
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Bit Meaning When Set 6 
0 Device connect time may be incorrect 
1-31 Reserved 


error during allocation or in a preceding job step, or 


binary |{TCBCMPC Step completion code: 
X‘Occc’ indicates system ABEND in the job step where ccc 
is the system ABEND code. (See Message Library: 
System Codes.) 
X‘8ccc’ indicates user ABEND in the job step where ccc is 
the user ABEND code. 
X‘nnnn’ indicates normal completion where nnnn is the 
contents of the two low-order bytes in register 15 at 
termination. 
X‘0000’ indicates either: 
(1) the job step was flushed (not executed) because of an 
(2) normal job completion with a return code of 0. 


(Continued) 


The job name and the time and date that the reader recognized the JOB card for this job constitute the 
job log identification. 


Sif no value is specified for the PRTY parameter on the JOB card, this field contains: 


@ For JES3, the default priority specified on the JES3 STANDARDS initialization card 

@ For JES2, a zero. 

Note that JES2 does not use the priority value reported in this field. (The JES2 job selection priority 
_is requested via the JES2 PRIORITY control statement.) : 


4 a batch job or a started task successfully executes TPUTs, this field might be non-zero 


for batch jobs or started tasks. ff ; om 


SF or a DIV object, this field contains total device connect time for reads, writes and re-reads. ee Y 


Sie this flag is set, the SRM disabled the channel measurement while the job was executing. If 
channel measurement is disabled, device connect time is not recorded. Therefore, if this bit is 
set, SMF30TCN and SMF30DCT reflects less than the actual total connect time. 
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binary | ASSBASRR Total Address Space REREAD Count Dw 
TCTRRCT | 














Torte | noww [ain [Format | sowe [SCs 


Completed Section (continued): 





SMF30OST|I binary Step termination indicator: 


Bit Meaning When Set 
0-1 Reserved 
JCTJMRCL Canceled by exit IEFUJI 
JCTJMRCL Canceled by exit IEFUSI 
JCTJIMRCL Canceled by exit |EFACTRT 
JCTSTEPR Step is to be restarted 
TCBFA If 0, normal completion. If 1, ABEND. If step 
completion code equals 0322 or 0522, IEFUTL 
caused ABEND. If step completion code equals 
0722, |EF USO caused ABEND. 
TCTHWM If O, normal completion. If 1, step was flushed. 
TCT EXCP counts might be incorrect because the 
record did not include all the DD statements. 
SMF30ISK Previous interval record was not written because an 
error occurred. The cumulative count might be 
| incorrect because the counters were cleared. 
10-15 Reserved 


SMF30ARC | 4 | binary | TCBARC Abend reason code | 


Processor Accounting Section: 












SMF30PTY 


Address space dispatching priority (taken from DPRT Y= 
parameter on EXEC card or the APG value in CVTAPG). 


aa aa_[swesoava [2 [einy [Cid Cees SSCS 


| +4 +4 |SMF30CPT binary ASCBEJST Step CPU time under TCB in hundredths of a second!® 
| or ACTJTIME 
_ TCTEJST | 
| +8 +8 |SMF30CPS binary | ASCBSRBT Step CPU time under SRB in hundredths of a second!® 
ty : or SCTSRBT 
( | — TCTSRBT 


{ +12 +C |SMF30ICU binary ASCBEJST Initiator CPU time under TCB in hundredths of a 
+ TCTITCB second 13 
+16 +10 | SMF30ISB binary ASCBSRBT Initiator CPU time under SRB in hundredths of a 
| + TCTISRB second 13 
| +20 +14 | SMF30JVU binary ASSBEVST Step vector usage time in hundredths of a second 
| or SCTTVFUT 
| —TCTEVFUT 
+24 +18 | SMFSOIVU binary ASCBEVST Initiator vector usage time in hundredths of a second 
+ TCTIVFUT 
+28 +1C | SMF3SOJVA binary ASSBVFAT Step vector affinity time in hundredth of a second 
or SCTTVFAT 
—TCTEVFAT 
+32 +20 | SMF3OIVA binary ASSBVFAT Initiator vector affinity time in hundredths of a second 
+ TCTEVFAT 












+36 SMF30IST EBCDIC Interval start time for type 30 subtype 2 and 3 records 
+ +40 SMF30IDT EBCDIC Interval start date for type 30 subtype 2 and 3 records 


13 (Continued) 
CPU time is not expected to be constant between different runs of the same job step. 
For more informaiton on CPU time, see Chapter 9. 
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EXCP Section:© 





+ 


+ 


SMF30DDN EBCDIC| TIOEDDNM DD name used to access the data set 


12 | SM F30B LK 4 binary TCTDCTR — Count of blocks issued for the device against the data 
TCTOCRS set 


+16 | +10] SMF30BSZ TCTBLKSZ Largest blocksize of the data set 


Bit When Set 
+121 SMF30DCT | 


+ 







8 


0 Indicates changed blocksize for the data set 
1-15 Largest blocksize of the data set 
4 binary TCTCONN Device connect time for this data set (in 128 micro- 
—TCTCONNS second units)! ? 
internal Length of accounting section, excluding this field 
EBCDIC EXEC statement Job or step accounting field 


Reserved. Note that SMF30RGN, formerly a two-byte 
' field at this offset, has been increased to four bytes and 
moved to the end of the Storage and Paging Section. 


+2 | +2 SMF30SFL 1 binary Storage Flags!© 
Bit Meaning When Set 
V=R is specified! 4 
|IEFUSI changed region limit values for the 
extended private area 
Reserved | 


SMF30SPK aE dk TCBPKF Storage protect key, in the form xxxx0000 where xxxx is 
the key 


+4 +4 SMF3OPRV 2 binary TCTLWM/1024 Largest amount of storage used from bottom of private 
area, in 1K units. This storage area includes subpools 
- _ 


0-127, 251 and 252. If ADDRSPC=REAL is specified, 
- _ 


this field equals the amount of contiguous real storage 
6 For each device assigned to each data set there is a 22-byte EXCP section. (Continued) 


that was used. 19 
7 Entries for virtual 1/O data sets are zero for class and type, and X‘7 FFF’ for device number. If the high order bit of the device 
field is on, it indicates a virtual device. 
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Largest amount of storage used from top of private area, 
in 1K units. This storage area includes the LSQA and 
SWA (subpools 229, 230, 236, 237 and 253-255). If 
ADDRSPC=REAL is specified, this field equals the amount 
of storage used that was not from the contiguous real 
storage reserved for the program. 








Number of non-V!IO, non-swap page-ins for this step. This 
field includes page-ins required through page faults, specific 
page requests, and page fixes. It does not include page 

reclaims, page-ins for VIO data sets, pages that are swapped 
in, and page-ins for the common area. 


SPost processors should use this field to avoid the possibility of negative numbers. 


Seach entry in an accounting field contains the lenath of the field in the first byte, followed by the field. An omitted fi 
indicated by a 0 in the first byte. 


wD 
@ 
rr) 


10 j¢ storage was not allocated (job step was flushed), these fields equal zero. 


11This bit has no meaning for subtype 5 records. 
12 


For a DIV object, device connect time is not collected by SMF however this field may not always be O. For example, if a user 
is using a DIV dataset and calls a VSAM utility to process it using the same DD statement, this will result in device connect 
time being charged by VSAM to the DIV object. 
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SMF30PGO 










Number of non-VIO, non-swap page-outs for this step. This 
field includes page-outs required through specific page 
requests as well as those pages stolen by the paging super- 
visor as a result of infrequent use. It does not include 
page-outs for VIO data sets, pages that are swapped out, 
and page-outs for the common area. 


SM | SMF3OREC | EC | sMF30REC| 4 | binary — | OUXBPREC | Number of private area reclaims 


+14 SMFS3ONSW hin aes Number of address space swap sequence. (A swap sequence 


consists of an address space swap-out and swap-in. 
+18 | SMF3OPSI a7 OUXBSPIN 


Logical swap-out and swap-in are not included). 
ie +1C | SMF30PSO ind OUXBSPOT 





































Number of pages swapped in. This field includes: (LSOQA, 
fixed pages, and those pages that the real storage manager 
determined to be active when the address space was 
swapped in. It does not include page reclaims or pages 
found in storage during the swap-in process (such as pages 
5Srought in via SRB’s started after completion of swap-in 
State 1 processing). 









Number of pages swapped out. This field includes: LSQA, 
private area fixed pages, and private area non-fixed changed 
pages. 


Number of VIO page-ins for this step. This field includes 
yage-ins resulting from page faults or specific page requests 
ona VIO window. It does not include VIO swap-in or 
page-ins for the common area. 





+20 | SMF30VP! ae OUXBVAMI 
+24 | SMF30VPO ia OUXBVAMO 






Number of VIO page-outs for this step. This field includes 
page-outs resulting from specific page requests on a VIO 
window as well as those pages stolen by the paging super- 
visor as a result of infrequent use. It does not include VIO 
swap-Outs Or page-outs for the common area. 
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Cortes [Name [non | Format 


Storage and Paging Section (continued): 
+40 SMFS30OVPR 4 binary OUXBVAMR Number of VIO reclaims 
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ae 
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SMFS3OPST OUXBSTCT Number of pages stolen from this address space 


+64 40 SMF30PSC binary OUCBPSS J 
space, in page millisecond units 


| 48} SMF30RGB TCTRGNB Private area size in bytes, below 16 megabytes 
SMF30ERG TCTERGNB Private area size in bytes, above 16 megabytes 


.50 SMF30ARB 4 binary TCTHWM Maximum virtual storage in bytes allocated from the 
LSQA and SWA subpools below 16 megabytes 
54 SMF30EAR binary TCTEHWM Maximum virtual storage in bytes allocated from the 
LSOQA and SWA subpools above 16 megabytes 
8 SMF30URB binary TCTLWM Maximum virtual storage in bytes allocated from the 
user subpools below 16 megabytes 
+92 5C SMF3SOQ0EUR binary TCTELWM Maximum virtual storage in bytes allocated from the 
user subpools above 16 megabytes 


+96 SMF30RGN binary TCTRSZ*2 Region size established, in 1K units taken from the 
REGION=parameter in the JCL, and rounded up toa 
4K boundary. If ADDRSPC=REAL is specified, this 
field equals the amount of contiguous real storage 
reserved for the program. If the region requested was 
greater than 16 megabytes, the region established resides 
above 16 megabytes, and this field will contain a 
minimum value of 32 megabytes. 


Number of CPU page seconds for this address. 
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[ones [nme [uot] Former [Sows [Seino 


Performance Section: 
SMF30SRV binary OUXBJBS + Total service units 
OUXBTRS 


+4 +4 SMF30CSU binary OUXBJCPU + CPU service units 
OUXBTCPU 

+8 +8 SMF30SRB binary OUXBJSRB + SRB service units 
OU XBTSRB 

+12 +C SMF3010 binary OUXBJIOC + 1/O service units 
OUXBTIOC 





+16 +10| SMFSOMSO binary OU XBJMSO + MSO service units 
OUXBTMSO 
} +20 


+14) SMF30TAT 4 binary OUXBJBT + Transaction active time in 1024-microsecond units. 
OUXBTRT 


[ae [a[sursoret | 4 [orev | +i Rees SOSC—C—~—SCSCS 


+28 | +1C] SMF30RES binary OUXBJBR + Transaction residency time in 1024-microsecond units. 
OUXBTRR That is the amount of time the transaction was in- 
real storage. 
+32 +20] SMF30TRS binary OUXBTRC | Number of transactions 
O for all non-TSO users 
Operator Section: 
+0 |+0 1] smF30PDM binary | TCTPDADS Number of non-specific DASD mounts! 2 


SMF30PRD binary | TCTRDASD Number of specific DASD mounts12 


+8 SMF30PTM 4 | binary | TCTPTAPE Number of non-specific tape mounts 12 





| 4 | binary | TCTRTAPE Number of specific tape mounts! 
10] SMF30MTM = ae binary TCTPMSS Number of non-specific MSS mounts 12 


+20 | +141 SMF30MSR binary TCTRMSS Number of specific MSS mounts 12 


2 The count is increased by one when the mounted volume is verified. Thus, if an incorrect 
volume is mounted the count is not increased even though another mount message is issued. 
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] cue ae ‘ A 
Record Type 31 (1F) — TIOC Initialization | — 
—_ 
Record type 31 is written by IEDAY]1 when a MODIFY tcam operator command 
is issued. This record contains the number of time-sharing buffers, buffer size, 
maximum number of output and input buffers allowed per terminal before OWAIT? 
or LWAIT? , OWAIT and RESTART thresholds, number of buffers reserved on the 
free queue, and the size of one terminal status block. Its length is 58 bytes. 
The format is: 
[offsets [Nome [onath [ Format | Soure 
fo fo | TTIsiten | 2 [binary [internal | Record length 
(2 [2 | trstsec | 2 [binary | internal 
| TTIRFLG binary System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
6 VS2 
| 7 Reserved 
rs_[s_| trinopry| 1 [binary [internat | Recordwpes SSCS 
TTIRCDTS binary |SVC 83 Time, in hundredths of a second, record was moved to 
| . SMF buffer . 
A TTIRCDTE 4 packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 
EBCDIC | SMCASID System identification (taken from SID parameter) 
Ky 





binary | TIOCNBF 


a 


TTINBF 


Number of time-sharing buffers es 


(in TIOCRPT) 2 
TTIBUFSE binary | TIOCBFSZ | Time-sharing buffer size, in bytes 
(in TIOCRPT) 


il al dad 
il il Mad 
Ll id ci 
Gal ll 
i al ed 


rea [ae [truss 


Sled Hii 
[a [as [Tree 


1QOWAIT is the suspension of the program during input/output processing to the terminal 
because no output buffers are available. 


2LWAIT is the locking of the terminal’s keyboard because the terminal user filled all of 
the available input buffers. 


binary Reserved 


TIOCAOMX 
(in TIOCRPT) 


TIOCAIMX 
(in TIOCRPT) 


TIOCWTH 
{in TIOCRPT) 


TIOCRSTH 
(in TIOCRPT) 


TIOCUSLW 
(in TIOCRPT) 


binary Maximum number of output buffers allowed per terminal 


before OWAIT2 


Maximum number of input buffers allowed per terminal 
before LWAIT2 


OWAIT threshold. The number of buffers that must be 
freed in order to be freed from OWAIT. 


RESTART threshold. The number of buffers that must 
be freed in order to be freed from LWAIT.2 





binary 













binary 





binary 








binary Number of buffers reserved on the free queue. (Less than 


this number results in a system-wide LWAIT.2) 


binary Reserved 





TIOCTSBS 
(in TIOCRPT) 


binary Size of one terminal status block (TSB) 


binary Reserved 
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Record Type 32 (20) — TSO User Work Accounting Record 





Record type 32 is written by IEFTB721 at normal or abnormal termination of a 
TSO session or by IEFTB727 at the expiration of a TSO accounting interval. 


To use the type 32 record, you must have installed MVS TSO/E. 


The record contains the names of the commands and the number of times each 
command was used during the session as well as the device connect times for 
each command. For more information see “Transaction Billing’? and “TSO 
Command Accounting”. Its length is variable. 


Notes: 


1. TSO commands entered from batch jobs are not counted; type 32 records are 
produced for TSO sessions only. 


2. Aliases of commands are counted in separate entries in the record. For instance, 
SEND and SE are counted as separate commands. 


3. The resource data found under logon (if DETAIL is specified in SMFPRMxx) 


represents the resources used from the start of the session to the time when the 
first command is obtained. 


4. This record can be used with the subtype selectivity function. Refer to 
Chapter 3, Part III, for a description of subtype selectivity. 


The format is: 


4 SMF32FLG | SVC 83 System indicator 
Bit (Meaning When Set 

Subsystem name follows system identification 
Subtypes utilized 

-4 Reserved 
MVS/XA 
VS2 
VS1 . 


SMF32RTY ae _ Record type 


SME32TME SVC 83 "Time, in hundredths of a second, record was moved to SMF 


buffer 
SMF32DTE 


“WO OTN = © 


> 


OOYYDDDF, where F is the sign 


/SMF32siD | 4 | | SMCASID System identification (taken from the SID parameter) 


SVC 83 Date record was moved to SMF buffer, in the form 


mh 


—_ 


2 SMF32WID EBCDIC OUCBSUBN Subsystem identifier 
SMF32STP binary ~ Record subtype 
binary internal Offset to product section from start of record, including 
the RDW 


SMF32POF 


SMF32PLN 


SMF3210F 


| 2 | bi 

ca 
rewraain [2 | bien 

cc 

| 2 | bi 


Length of product section 


Number of product sections 


Offset to the identification section from start of record, 
including the RDW 


Length of the identification section 


_, 
O 


Number of identification sections 


[SMF a21ON 


SMF32COF 


2c | SMF32CLN | 2 


Offset to the TSO command section from start of record, 
including the ROW 


Length of the TSO command section 





Number of TSO command sections 
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Description 


orimss [ vane [tes [Format 


Product Section: 


SMF32TYP binary Sub type identification for the record: 
1 = TSO user interval record 

2= TSO user session end record 

3 = TSO user interval record with detail 


4 = TSO user session end record with detail 





Record version number — ‘02’: 


Identification Section: 


| 
© 





| Source 
Eee an 
ean 
0 SMF32JBN I, EBCDIC Job/session name 
al hl eed EE ees eee a identification (taken from common exit parameter 
ee Step number 
LS 
raa_[ ac | SMFS2PGN | 2 [binary |OUCBNPG | Jobperformence group number 
| +48 | 30 | SMF32AST | 4 |binary |TCTAST ~~ | Device allocation start time 7 
+52 | 34 | SMF32PPS | 4 binary |TCTPPST Problem program start time, in hundredths of a second 
[+56 Step initiation time 
Bal lait Scekaoked Bill ‘cued siglllt ee aad date, in the form OOY YDDDF, where F 
eal wt heed GE cel eel Reader start date, in the form OOY YDDDF, where F_ 
| _ is the sign | 
et 4 binary Time, in hundredths of a second, reader recognized the end 
| of the job or started task. For TSO, this is the logon 
enqueue time. 
ieee packed. ISMRDRSTP +4] Date, in the form OOYYYDDF, where F is the sign, reader 
recognized the end of the batch job or started task. For 
TSO, it is the logon enqueue date. 
#80 [50 | SMFS2USR [20 [EBCDICJACTINFLD | Programmer name 
| +108]6C | SMF32RUD| 8 | EBCDIC JACEEUSRI RACF user 1D 
+116 bid Seesuitea: Seem EBCDIC |ACEETRMF RACF terminal 1D | | 
0 if RACF is not active or user is not a terminal user. 





TSO Command Segment-Subtypes 1 and 2} 
SMF32CMD 8 EBCDIC TSO command name 


+0 
(8_[e | swrsacnt [4 [binary internal | Number of TSO command 


1 The subtype is indicated in offset 0 of the product section. Only those commands included in CSECT IEEMB846 are 
used. Data for all other commands is included in ‘***OTHER’. Only those commands that are entered at least once, 
during the session are included in the record. Invalid or unknown commands appear under ‘EXEC’. Subtypes 1 and 3 
contain data on TSO activity since the start of the session or since the last interval record was produced. Subtypes 
2 and 4 contain data on the cumulative TSO aétivity for the entire session. If there is no activity during an interval, no 


interval record is produced. The subtype is indicated in the SMF32TYP fieid. 





— a a oe 
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Description 


ee TSO command name 


Number of times the TSO command was entered 
Total TCB time for the command 






+ 


SMF32TCB 


+20 i 
+24 


+ 
Lee) 


SMF32TRN | binary | internal = Total transaction count for the command 
[#32 | 20 | SMFS2EXP 


+36 SMF32TCT ASCBDCTI 


IThe subtype is indicated in offset 0 of the product section. Only those commands included in CSECT |EEMB846 are 
used. Data for all other commands is included in ‘***OTHER’. Only those commands that are entered at least once, 
during the session are included in the record. Invalid or unknown commands appear under ‘EXEC’. Subtypes 1 and 3 
contain data on TSO activity since the start of the session or since the last interval record was produced. Subtypes 
2 and 4 contain data on the cumulative TSO activity for the entire session. !f there is no activity during an interval, no 
interval record is produced. The subtype is indicated in the SMF32TYP field. 


+ 





Total EXCP count for the command 






Total device connect time for this command 


ae 
ae 
4 
| 14 | SMF32TGT | 4 | binary | internal =| Total TGET count for the command 
| 18 | SMF32TPT | 4 | binary | internal =| Total TPUT count for the command 
La 
el 
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Record Type 34 (22) — TS-Step Termination 


Record type 34 is constructed by IEFTB722 and written by IEFTB721 when the 
TSO logoff function processes a job step termination. Its length is 202 bytes plus 
(1) eight bytes for each device entry and (2) the length of the step accounting fields. 


This record identifies the job by job name, logon time and date, user identification, 


program name, and performance group number. If accounting numbers (which can 
be alphameric) were specified on the EXEC card, they are included. 


This record also contains operating information such as initiator start time, 
number of TPUTs issued, number of TGETs satisfied, termination status, device 
allocation start time, problem program start time, step CPU time, step service, and 
storage protect key. It contains the number of page-ins, page-outs, swap-ins, and 
swap-outs for both VIO and non-VIO data sets. 


Record type 34 also has an entry for each non-spooled data set that was defined 
by a DD statement. Each entry lists the device class, unit type, 
device number, and EXCP count for the data set. 
Notes: 
1. Data sets are recorded in the order of the step DD staternents; they are not 
identified by name. (A user-written IEFUJV exit routine can record this order 
as each statement is validated.) 


2. For data sets that are dynamically unallocated, the data set entry information is 
in record type 40 — not in record type 34. 


3. For more information on EXCP count and CPU time, see Chapters 8 and 9, 
respectively. 


The format is: 


ee nee. a TIV34SEG [binary internal Segment descriptor 


i 7 ii ~ . 


TIVRCDTY | 1 [binary | 
TIVRCDTS binary oe 83 Time, in hundredths of a second, record is passed to the 
. SMF writer. This is the time the step terminated. 
= in a a _ 








System indicator 


Bit Meaning When Set 
0-4 Reserved 








5 MVS/XA_ 
6 VS2 
7 Reserved 











Date, in the form OOYYDDDF where F is the sign, record 
is passed to the SMF writer. This is the date the step 
terminated. 






}14 | E TIVCPUID | 4 EBCDIC] JMRCPUID System identification (taken from, SID s arameter) 


rs_[a2_[rivuir [8 | escoic| awnsos 
pe | 8 1A_|[TIVONTME cle JMRENTRY Logon time, in hundredths of a second 


TIVONDTE JMREDATE Logon date, in the form OOYYDDDF where F is the sign 


TIVUDATA EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area) 


42 | 24 [TivINVsa | 1 [binary {LCTSNUMB Step number. (This field always equals 1.) 


bial ok TIVSIT 7 fom JCTJMRSS (Set by Time, in hundredths of a second, initiator selected this step 
IEFSMFIE) 


(Continues) 
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TIVOUTCT binary TCTLOUT Number of lines of terminal output, that is, number of 
TPUTs issued 
51 33 TIVINCT binary TCTLIN Number of lines of terminal input, that i is, number of 
TGETs satisfied 


55 37 TIVSTAT binary TCBCMPC Step completion code: 
X‘Occc’ indicates system ABEND where code is the 
system ABEND code. (See System Codes.) 
X‘8ccc’ indicates user ABEND where ccc is the user 
ABEND code. 
X‘nnnn’‘ indicates normal completion where nnn is the 
contents of the two low-order bytes in register 15 at 
termination. 
X ‘0000’ indicates either (1) the job step was flushed (not 
executed) because of an error during allocation, or (2) 
normal job completion with a return code of 0. 
Use this field in conjunction iwth the step-termination 
indicator field (offset 87). 


TIVPRI binary SCTSDPTY Address space dispatching priority (taken from DPRT Y= 
parameter on EXEC card or the APG value in CVTAPG). l 
3A TIVPRGNM EBCDIC | SCTPGMNM Program name (taken from PGM = parameter on EXEC 
card). If a backward reference was used (SCTSTYPE 
equals X‘80’), then this field contains *.DD. 
| TIVINVNM | | EBCDIC | SCTSNAME Step name (taken from name on EXEC cara) 
eueae bagel eee Reserved. Note that TIVEFRGN, formerly a two-byte 
field at this offset, has been increased to four bytes and 
moved to offset 82. 
‘ i 7 rE _ 
TIVMCRE binary TCTLWM/1024 
this field equals the amount of contiguous real storage 
that was used. See offsets 82 and 102.2 
greater than 16 megabytes, the region established resides 
upon characteristics. If the dispatching priority is not in the APG range, the value in field TIVPRI will be the actual execution 


above 16 megabytes, and this field will contain a 
dispatching priority. For more information, see /nitialization and Tuning. 


















Largest amount of storage used from top of private area, 
in 1K units. This storage area includes the LSQA and 
SWA (subpools 229, 230, 236, 237 and 253-255). If 
ADDRSPC=REAL is specified, this field equals the 
amount of storage used that was not from the contiguous 
real pene reserved for the program. See offsets 82 and 
102. 


Largest amount of storage used from bottom of private 
area, in 1K units. This storage area includes subpool! 
0-127, 251 and 252. If ADDRSPC=REAL is specified, 






















a eer —— a Region size established, in 1K units taken from the 
minimum value of 32 megabytes. 


REGION= parameter in the JCL, and rounded up to a 
; haa ewe TIVSPK es TCBPKF Storage protect key, in the form xxxxO000 where xxxx 
: : is the key 


four K boundary. If ADDRSPC=REAL is specified, this 
(Continued) 


field equals the amount of contiguous real storage 
reserved for the program. If the region requested was 
11f the dispatching priority falls within the APG range, the actual execution dispatching priority will be assigned based on the 
Installation Performance Specification (IPS). If the dispatching priority is controlled via the IPS, it may periodically change based 


21f storage was not allocated (job step was flushed), these fields equal zero. 
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Meaning When Set 


Reserved 
JCTJMRCL _ Canceled by exit IEFUJIS 
5A . TIVAST binary | TCTAST (Set by Device allocation start time, in hundredths of a second 
1EFBB401) 
TIVPPST 4 binary | TCTPPST (Set by Problem program start time, in hundredths of a second 
1EFABS820) 


JCTJMRCL Canceled by exit IEFUSI® 
[ea | 62 | Tivave piney | | COReneed SC 


JCTJMRCL Reserved 
JCTSTEPR Step is to be restarted 
TIVSRBT binary | SCTSRBT Step CPU time under SRBs, in hundredths of a second. 
This field includes the CPU time for various supervisory 
ii 7 


if 0, normal completion. 

TCBFA lf 1, ABEND. If step completion code (offset 55) 
routines that are dispatched via SRBs: locking routines, 
page resolutdon, swap control, cross-memory communica- 

il a 










equals 0322 or 0522, |EFUTL caused ABEND. 
lf step completion code equals 0722, |EFUSO 

tions (WAIT, POST, I/O POST), and TQE scheduling.4 

Record indicator 


caused ABEND. 
Bit Meaning When Set 


[offsets [Name | Length] Format] Source [| ——~—~—~—~S—Seseription CS 
87 | 57 TIVSTI binary Step termination indicator 
TCTHWM If O, normal completion. 
If 1, step was flushed. 
0-4 Reserved 
TCTIEX Device data not recorded 


binary 


EXCP count may be wrong 5 
SCTSSTAT If O, storage is virtual. 
If 1, storage is real. 
8-15 Reserved 


‘binary | internal Offset from the beginning of the record header to the 
relocate section 

binary Length of device entry portion of record. Calculated as: 
(8 times the number of devices) + 2 


For each device assigned to each non-spooled data set, there is an eight-byte entry with the following format: 6 























+0 0 TIVDEVC binary | UCBTBYT3 Device class 
+4 1 TIVUTYP binary | UCBTBYT4 Unit type 
+2 2 TIVCUAD binary | UCBCHAN Device number 





TIVNEXCP EXCP count (see offset 102)5 


binary | TCTDCTR 


5 (Continued). 
Job steps canceled by IEFUJI and IEFUSI will not be executed; therefore bit 7 will also be on. 

4 CPU time.is not expected to be constant between different runs of the same job step. For more information 
on CPU time, see Chapter 9. 


5 1f aGETMAIN for expanding the TCTIOT (the data area where EXCPs are maintained) fails, only the existing 
data sets are counted. If the functional recovery routine is entered, EXCP counting for the step is discontinued 
and no device entries are produced. If ADDRSPC=REAL is specified, the EXCP count does not include PCis. 

_ For more information on EXCP count, see Chapter 8. 

Sentries for DD*, DD DATA, DD DUMMY and spooled data sets are zero. (A DD DUMMY 
entry results when a forward reference to a DD statement having that DD name is not found 
or when DD DUMMY is specified.) Entries for VIO data sets are zero for class and type, 

X'7FFF' for device number. When the high order bit in the Gevice number fieid is on, it 
indicates a virtual device. 


i When the TIOT size is greater than 32K (more than 1635 DD statements), device data is not 
collected for the type 34 record. The data is available in the type 30 record. 
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Lortens | Name __[tonsth | Format | source | ascriptton 


After the device entries are the following fields: | 
Te Section: 


| TIVVARA | | binary | internal | Length of accounting section, excluding this field. = | Length of accounting section, excluding this field. = accounting section, excluding this field. 






















eae nm ACTJT SS =— Step CPU time under TCBs, in hundredths of a 
second. This field includes the CPU time for all tasks 
that are dispatched via TCBs below the level of RCT.* 
contains the length of the field (one byte, binary) 

Relocate Section: 

TIVPGIN’ binary | OUXBPIN Number of non-V1O, non-swap page-ins for this step. 
This field includes page-ins required through page 
faults, specific page requests, and page fixes. It does 
not include page reclaims, page-ins for VIO data sets, 
pages that are swapped in, and page-ins for the 
common area. 
page requests as well as those pages stolen by the 


TIVNBRAC | 1 | binary _| | Number of accounting fields§ = of | Number of accounting fields§ = fields. 
followed by the field (EBCDIC). A zero indicates 
+4 +4 TIVPGOUT 4 binary | OUXBPOUT Number of non-VIO, non-swap page-outs for this step. 
paging supervisor as a result of infrequent use. It does 


a TIVACFLD on a neal EXEC statement Accounting fields. Each entry for an accounting field 
an omitted field. 

This field includes page-outs required through specific 

not include page-outs for VIO data sets, pages that are 


swapped out, and page-outs for the common area. 


Number of address space swap sequences. (A swap 
sequence consists of a physical swap-out and swap-in 

of an address space. Logical swap-out and swap-in are 
not included). _ 


Number of pages swapped in. This field includes: 
LSOQA, fixed pages, and those pages that the real 
storage manager determined to be active when the 
address space was swapped out. It does not include 
page reclaims nor pages found in storage during the 
swap-in process (such as pages brought in via SRB‘s 
started after completion of swap-in Stage 1 


+12 | +C TIVSIN binary |OUXBSPIN 
processing). 


+16 | +10 TIVSOUT binary | OUXBSPOT Number of pages swapped out. This field includes: 
LSOA, private area fixed pages, and private area non- 
fixed changed pages. 
TIVVPI a OUXBVAMI Number of VIO page-ins for this step. This field 
























includes page-ins resulting from page faults or specific 
page requests on a VIO window. It does not include 
VIO swap-ins or page-ins for the common area. 


Number of VIO page-outs for this step. This field 
includes page-outs resulting from specific page 
requests on a VIO window, as well as those pages 
stolen by the paging supervisor as a result of 
infrequent use. It does not include VIO swap-outs or 
page-outs for the common area. 















binary | OUXBJBS + Step service, in service units. This field is calculated as 
OUXBTRS total job service minus the accumulated job service prior 
to this step’s initialization. 
Step transaction active time, in 1024-microsecond units. 
Calculated as total job transaction active time minus the 
accumulated transaction active time pior to this step’s 


+32 binary | OUXBJBT + 
OUXBTRT 
initialization. 
+36 TIVPGNO binary | OUCBNPG Step performance group number (taken from PER FORM= 
parameter Qn JOB or EXEC card or the RESET operator 
command).” | 


(continued): 


4CPU time is not expected to be constant between different runs-of the same job step. For more information on 
ci time, see Chapter 9. 


8 the displacement of this field depends upon the size of the accounting fields and the number 
of devices. Offset 104 contains the displacement for this field. 


8 FoF more information on service, transaction active time, and performance group number, 
see /nitialization and Tuning. 
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Description ies / 


Step transaction residency time, in 1024-microsecond 


units. That is the amount of time the transaction was in 


| +38 | 26 TIVTRANT binary | OUXBJBR + 
OUXBTRR 
real storage. 


















TIVRECLM 4 OUXBPREC Number of private area reclaims for this step 
+50 | 32 TIVCPGIN binary | OUXBCAPI Number of common area page-ins for this step 
— (LPA + CSA) 
+62 | 3E TIVPGSEC binary | OUCBPSS Number of page seconds for this step, in page millisecond 
units. Calculated as: the number of pages used by this 
pages. 
| +70 | 46 | TIVLPAI | 4 | binary | OUXBLPAI Number of link pack area page-ins for the step 
+78} 4E TIVCPUS binary | OUXBJCPU + Step CPU service, in service units? 
OUXBTCPU 
+82 | 52 TIVIOCS binary | OUXBJIOC + Step I/O service, in service units” 
OUXBTIOC 
+90 | SA TIVSRBS 4 binary | OUXBJSRB + Step SRB service, in service units” 
OUXBTSRB 
2 For more information on service, transaction active time, and performance group number, 


TIVRCLAM| 4 | binary | OUXBVAMR Number of VIO reclaims for this step 
Number of common area reclaims for this step 
, (LPA + CSA) 
| +58 | 3A | TIVPGSTL OUXBSTCT Number of pages stolen from the storage for this step 
step times the execution time it held that number of 
TIVLPAR | 4 | binary | OUXBLPAR Number of link pack area reclaims for the step 
+86 TIVMSOS binary | OUXBJMSO + Step main storage service, in service units” 
OUXBTMSO 
see Initialization and Tuning. | te, < vy 


a TEN 
“ \ 
s 
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Record Type 35 (23) — LOGOFF 





Record type 35 is constructed by IEFTB722 and written by IEFTB721 when a 
logoff process is completed. Its length is 137 bytes plus the length of the job 
accounting fields. 

This record identifies the job by job name, logoff time and date, logon time and 
date, user identification, and performance group number. If accounting numbers 
(which can be alphameric) were specified on the JOB card, they are included. 


This record also contains operating information such as number of TPUTs issued, 
number of TGETs satisfied, termination status, storage protect key, job service, 
transaction active time, number of transactions, and job CPU time. 


Notes: 
1. For more information on CPU time, see Chapter 9. 


2. If the terminal I/O controller (TIOC) does not attempt to send output (for 
example, a message) to a terminal whose line has been disconnected, it will 
not detect a line disconnect. To SMF, a terminal session interrupted by a 
line disconnect is considered to be executing and a type 35 record will not 
be issued until: | 
e The disconnect situation is detected, the reconnect time limit expires, 

and the system cancels the session (with a completion code of 622); or 


e The disconnect situation is detected, the user reconnects, and sub- 
sequently issues a LOGOFF command. 


( The format is: 


Soure 
TLG35LEN 


binary Record length | 


TLGSSSEG binary 
TLGRFLG binary | SVC 83 System indicator 


Bit Meaning When Set 
0-4 Reserved 


MVS/XA 
VS2 
Reserved 





internal 


TLGRCDTY 


TLGRCDTS 
TLGRCDTE 


A [TLGONTWE 


TLGUDATA 


A TLGSTPCT 
TLGCRTME 


TLGOUTCT 
TLGINCT 





binary Record type 










Time, in hundredths of a second, record is passed 
to the SMF writer. This is the logoff time. 


Date, in the form OOYYDDDF where F is the sign, 
record is passed to the SMF writer. This is the logoff date. 


EBCDIC System identification (taken from SID parameter) 
EBCDIC Job name 

binary | JMRENTRY Logon time, in hundredths of a second 

JMREDATE Logon date, in the form OOY YDDDF where F is the sign 
EBCDIC | JMRUSEID 


binary 










ked | SVC 83 


pa 





—_ 


User identification (taken from common exit parameter 
area) 


binary | JMRSTEP Number of steps in session. (This field always equals 1.) 


binary Reserved 


Number of lines of terminal output, that is, number of 
TPUTs issued 


binary | TCTLIN Number of lines of terminal input, that is, number of 
TGETs satisfied 


(Continued) 


TCTLOUT 


binary 





“I 
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| Offsets | Name —_| Length | Format 


L : L 


te _ ne _ 


| TLGNOTME | | 4 | binary — 'binary | JMRDRSTP 
Paeaneete Lae eee JMRDRSTP + 4 


fatindiol Bh ecw 
| 7 


fa7_[ as | TLGOUTCL | 1 [binary [i Reserved 


di TLGTRANT HS OUXBJBR + Job transaction residency time, in 1024-microsecond units. 


OUXBTRR That is the total amount of time all transactions were in 
-4s_[TuGRvc {| 4 | binary 


real storage. 
pepe a ee 


Reserved 
Phi _ aa 


Storage protect key, in the form xxxx0000 where xxxx | 
is the key 
al ell li 


‘Job CPU time under SRBs, in hundredths of a second. This 
field includes the CPU time for various supervisory routines 

sal ed ic Ml 

[ee | 88 [rucnTsN [4 [binary 





Source 


TCBCMPC Job completion code: 


X’Occc’ indicates system ABEND where ccc is the system 
(See Message Library: System Codes.) 


X‘8cce’ indicates user AB END where ccc is the user 
ABEND code. 
X‘nnnn’ indicates normal completion where nnnn is the. 
contents of the two low-order bytes in register 15 at 
termination. 
X‘0000’ indicates normal job completion with return 
code of 0. 
| Use this field in conjunction with the job termination 
indicator field (offset 66). 
| Logon priority. This field normally equals the user-assigned 
priority of 0-13, but if the job fails while being scheduled, 
this field equals 14 (taken from the PRTY parameter on 
the JOB card)* 


| Logon enqueue time, in hundredths of a second 
‘Logon enqueue date, in the form OOY YDDDF where F 
is the sign : | | 


Job termination indicator 


Bit Meaning When Set 

0-1 Reserved 

2 Canceled at exit IEFUJI 
3 Canceled at exit [EFUSI 





































JCTJMRCL 
JCTJMRCL 


4-5 Reserved 
6 If 0, normal completion. If 1, abnormal 
termination 


Reserved 














SCTSRBT 







that are dispatched via SRB: locking routines, page resolu- 
tion, swap control, cross-memory eemounicanons (WAIT, 
POST, I/O POST), and TQE scheduling.+ 


Job service, in service units@ 










OUXBJBS + 
OUXBTRS 


OUXBJBT + 
OUXBTRT 
OUXBTRC 










Job transaction active time, in 1024-microsecond units? 






Number of transactions? _ 
(Continued) 


'opu time may not be constant between different runs of the same job. For more information on CPU time, see Chapter 9. 


2F or more information on service, transaction active time, and performance group number, see /nitialization and Tuning. 
Note that the service, active time, and residency time may have been accumulated under different performance group 
numbers. 
31f no value is specified for the PRTY parameter on the JOB card, this field ¢ contains 
e@ For JES3, the default priority specified on the JES3 STANDARDS initialization cara 
e For JES2, a zero. 


Note that JES2 does not use the priority value reported in this field. (The JES2 job selection priority is requested via the 
JES2 PRIORITY control statement.) 


6-96 System Management Facilities (SMF) 
























| Offsets | | Name | | Name [Length | Format | p  Deseription | Deseription 


Beall TLGPGNO binary ae Performance group number (taken from PERFORM= 
parameter on JOB card or from a RESET or SET IPS 
: 7" 
194 | SE | TLGRV2 | 2 | binary | binary | Reserved |. | 


= TLGVAR | 1 | binary | —— Length of rest of record, excluding this field 
97 [61 | tucrve | 20 |escoic] | Reserved 


117 | 75 TLGCPUTM binary | ACTJTIME Job CPU time under TCBs, in hundredths of a second. This 
field inclues the CPU time for all tasks that are dispatched 
via TCBs below the level of RCT.2 

‘as balk TLGNBRAC ee ACTJNFLD Number of accounting fields 
| 79 TLGACFLD | variable} EBCDIC} JOB statement Accounting fields. Each entry for an accounting field 
| contains the length of the field (one byte, binary) 
followed by the field (EBCDIC). A zero indicates an 
omitted field. 
Relocate Section: 
TLGCPUS binary | OUXBJCPU + 
OUXBTCPU 
OUXBTIOC | 
+8 TLGMSOS binary OUXBJMSO + Job main storage service, in service units* 
. OUXBTMSO 
+12} 12 TLGSRBS binary | OUXBJSRB + Job SRB service, in service units 
OUXBTSRB | 


CPU time may not be constant between different runs of the same job. For more information on CPU time, see Chapter 9. 
























Job CPU service, in service units 








2 






Job !/O service, in service units 


2 . ° 7 ry . . ° o,e . e ° 
For more information On service, transaction active time, and performance group number, see /nitialization and Tuning. 


Note that the service, active time, and residency time may have been accumulated under different performance group 
numbers. 
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Record Type 36 (24) - Integrated Catalog Facility Catalog a J 


AMSXP01 partially builds record type 36 when an Integrated Catalog Facility 

catalog is exported. AMSSAQ2 then compiles and writes the record. The record 

contains information to identify the catalog being exported, the time of export, 

and information necessary to allocate the portable data set for subsequent import. 
It also identifies the job-by-job log identification and user identification. 


The SMF record is only written upon successful completion of the EXPORT 
command. The record contains the standard header and is formatted for the 
product and data sections. Its length is 214 bytes. For a description of the 
mapping macro, see record type 60. 
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The format is: 





Header Section: 


SMF36LEN 
SMF36SEG 
SMF36SYS 
SMF36RTY 
SMF36TME 
SMF36DTE 
SMF36CPU 
SMF36SBS 
SMF 36SUB 


Self-Defining Section: 


SMF 36NOT 


SMF 36POF 
SMF 36PLN 
SMF 36PNO 
SMF36DOF 
SMF36DLN 
SMF 36DNO 


Product Section: 


Data Section: 


SMF36PVN 
SMF36PNM 
SMF36PRL 


SMF36JNM 
SMF36RST 
SMF36RDT 
SMF36UID 
SMF36PGM 
SMF36CNM 
SMF36CVS 
SMF36CDT 
SMF36EDT 
SMF36ETM 
SMF36PDS 
SMF36PVS 


SMF36PDT 


| SMF36EIN 


ND A LH BHR BP | —| NY NM 


hm NM FB NY NO HB NY ND 


binary 
binary 
binary 
binary 
binary 
packed 
EBCDIC 
EBCDIC 
EBCDIC 


| binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 


EBCDIC 
EBCDIC 
EBCDIC 


EBCDIC 
binary 
packed 
EBCDIC 


EBCDIC | 


EBCDIC 
EBCDIC 
binary 

EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 


binary 


EBCDIC 


internal 
internal 
SVC 83 
internal 
SVC 83 
SVC 83 
SMCASID 
SVC 83 


internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 


internal 
internal 


internal 


JMRJOB 
JMRENTRY 
JMREDATE 
JMRUSEID 
internal 
internal 
UCBVOLI 
UCBTYP 
internal 
internal 
internal 
UCBVOLI 


UCBTYP 


internal 


Record Length 
Segment Descriptor 
Header Flag Byte 
Record Type 

Record Written Time 
Record Written Date 
System Identification 


Subsystem ID 


Record Subtype 
‘00’ - Export ICF Catalog 


Number of Triplets 
Reserved 

Offset to Product Section 
Length of Product Section 
Number of Product Sections 
Offset to Data Section 
Length of Data Section 


Number of Data Sections 


Product Version 
Product Name 
Record Type 36 Level 


Job Name 

Reader Start Time 

Reader Start Date 

User Identification Field 

Program Name 

ICF Catalog Name 

Catalog Volume Serial, if available 
Catalog UCB Device Type, if available 
Date of Export (mm/dd/yy) 

Time of Export (hh:mm:ss) 
Portable Data Set Name 


Portable Data Set Volume 
Serial (first/only volume), if available 


Portable Data Set UCB Device 
Type (associated with the first/only volume), if available 


Export Indicator 
‘AE’ - Aliases Were Exported 
‘NE’ - No Aliases Exported 
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Record Type 37 (25) - Network Problems Determination Application ( » 


Record type 37 is written by NCCF whenever the NPDA REPORTS option is invoked 
and each time an NPDA input record passes the NPDA recording filters. 


This record contains event and/or statistical data. It includes information on resource 
names and types (common data section), error description and probable cause (events 
section), traffic information (statistical data section), and modem data (modem data 
section and LPDA-2 data section), and local area network data (LAN data section). All 
unused fields in record-type 37 are set to hexadecimal zeroes. 


Notes 
NPDA does not create a report record for the following: 


e RECFMS 01, 02, 03 (counter sets 1, 2, and 4), 05, and 06 
e solicited Network Management Vector Transport 0025 (NMVT) records 


@ arecord that results from intensive mode recording 


co 


( 


ww 
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BRFRLEN 
BRFRSEG 
BRFRFLG 


BRFRRTY 
BRFRTME 


BRFRDTE 


BRFRSID 
BRFRWID 


BRFRSUBT 


BRFRPRODI 
BRFRPROLN 
BRFRPRONO 
BRFALLDI 
BRFALLLN 
BRFALLNO 
BRFEVTDI 
BRFEVLN 
BRFEVNO 


BRFSTADI 
BRFSTALN 


BRFSTANO 
BRFMODDI 
BRFMODLN 
BRFCMODNO 
BRFLPDDI 
BRFLPDLN 
BRFLPDNO 
BRFLANDI 
BRFLANLN 
BRFLANNO 





The format is: 


a 


MO NM F&F NY NY F NY DB B VY NY BP YS DY SF DY NY BN NY A 


binary 
binary 


binary 


binary 
binary 


pac ked 


EBCDIC 
EBCDIC 


EBCDIC 


binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 
binary 


binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


internal 


_internal 


SVC 83 


internal 


SVC 83 


SVC 83 


SMCASID 


internal 


internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 
internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internat 
internal 


internal 








Record length 
Segment descriptor 
System indicator 


Bit Meaning When Set 
0 Standard identification follows system identification 
Reserved 
MVS/XA 
VS2 
Reserved 


Record type 37 (X’25’) 


Time, in hundredths of a second, record was moved to SMF 
buffer 


Data record was moved to SMF buffer, in the form 
OOyydddF, where F is the sign 


System identification (taken from SID parameter) 


Subsystem identification ("NETV’) 


Record subtype 
(‘01' —- NPDA V3R2) 
(‘02’ — NPDA V3R3) 


Offset to product section 

Product section length 

Number of product sections (O or 1) 
Offset to common data sections 

Common data section length 

Number of common data sections (0 or 1) 
Offset to event section 

Event section length 

Number of event sections (O or 1) 


Offset to statistics section 
Statistics section length 


Number of statistics sections (O or 1) 
Offset to modem section 

Modem section length 

Number of modem sections (0 or 1) 
Offsec to LPDA-2 section 

LPDA-2 section length 

Number of LPDA-2 sections (0, 1, or 2) 
Offset to LAN section 

LAN section length 

Number of LAN sections (0 or 1) 
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Product Section: 


BRFSUBTY 


BRFREVLT 
BRFPRONM 


BRFTIMST 





Common data section: 


+0 

+8 

+16 
+20 
+28 
+32 
+40 
+44 
+52 
+56 
+64 
+68 
+76 
+80 


+52 


Event Section: 


+0 
+1 
+2 
+3 
+5 
+6 
+14 
+22 
+30 
+78 
+80 
+81 
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+0 

+8 

+10 
+14 
+1C 
+20 
+28 
+2C 
+34 
+38 
+40 
+44 
+4C 
+50 


+51 


+0 
+1 
+2 
+3 
+5 
+6 
+E 
+16 
+1E 
+4E 
+50 
+51 


BRFDOMNM 
BRFLRNM 
BRFLRTY 
BRFHINM1 
BRFHITY1 
BRFHINM2 
BRFHITY2 
BRFHINMS3 
BRFHITY3 
BRFHINM4 
BRFHITY4 
BRFHINM5 
BRFHITYS 
BRFCPL 


BRFALT 


BRFALRTT 
BRFGENCA 
BRFSPECA 
BRFBLKID 
BRFUACD 
BRFUAQL1 
BRFUAQL2 
BRFUAQL3 
BRF48TXT 
BRFDBKID 
BRFDUACD 
BRFNMVTY 


8 
8 
4 
8 
4 
8 
4 
8 
4 
8 
4 
8 
4 


—_ 


binary 


binary 
EBCDIC 


packed 


EBCDIC 


EBCDIC | 
EBCDIC | 


EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 


EBCDIC | 


EBCDIC 


EBCDIC | 


EBCDIC 
binary 


binary 
binary 
binary 
binary 
binary 
EBCDIC 
EBCDIC 
EBCDIC 


EBCDIC 
binary 
binary 


binary 


System Management Facilities (SMF) 


internal 


internal 


internal 


internal 
internal 
internal 
internal 
internal 


internal 


internal 


internal 


internal 
internal 
internal 
internal 
internal 


internal 


internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 





Record subtype 
(‘01’ — NPDA V3R2) 
—(102’ — NPDA V3R3) 


NPDA release level 


Product name: ‘NETV’ 


Time and date in the form OOY YDDDFHHMMSSOF where 


F is the sign 


Domain name 

Failing resource name 
Failing resource type 
Resource level 1 name 
Resource level 1 type 
Resource level 2 name 
Resource level 2 type 
Resource level 3 name 
Resource level 3 type 
Resource level 4 name 
Resource level 4 type 
Resource level 5 name 
Resource level 5 type 
Complex link indicator 
x'00' no 

x'01' yes 

Alert indicator 

x'00’ no 

x'01' yes 





Alert type for event record 
General cause for event record 


Specific cause for event record 


Block identification 
Action code 

Detail qualifier 1 
Detail qualifier 2 
Detail qualifier 3 


Error description: probable cause 


Detail Block id 
Detail Action code 


00=NMVT 0000 
O1=NMVT 0001 
02=NMVT 0025 

OF=MISC. NMVT 


FF=NON NMVT 




















en Cs 





+1 


+2 


+3 


rs 


( | +12 


+16 
+18 


+20 


+22 





BRFTRFFC 
BRFTEMPS 


Modem Section: 


+0 


+0 BRFFAIL 


+1 BRFLNKTY 


+2 BRFLMSIN 


+3 BRFRMSIN 


+4 BRFMODOD 
+6 BRFMODTP 


+C BRFMODSP 
+10 | BRFLNOQUL 
+12 | BRFHTCTL 


+14 | BRFLDOBIN 


+16 | BRFLDBNO 







binary internal Total traffic 















internal 





binary Total temporary errors 





Failure indicator 


X’00’ Not applicable 
X‘01' Modem probe 





internal 





binary 


X‘'02' Line 
X'03’ Remote device 
X'04' Communications (if unknown) 


X’05' 
Type of link 

X’01' BSC 
X’01’ SDLC 
Local modem status indicator - includes modem speed 
X‘00’ 
X'01’ 


Modem interface 








internal 





binary 

















binary internal 
















invalid 
valid 





Remote modem status indicator 
X‘'00' 
X'01' 


Modem address 


internal 





invalid 
valid 

































EBCDIC 
EBCDIC 





internal 








Modem type. This field contains either the machine 
number or N/AV (not available). 


internal 





EBCDIC 


binary 


internal Data rate (full or half) 








Local modem line quality (0-15) 


Local modem line hits (0-63). This field is model 
dependent. See relevant pubs for your modem model. 


internal 









binary internal 





This field indicates whether the Receive Level in DBm for 
the local modem is within measurable limits. 





binary internal 


Value Meaning 
X’0000' Not applicable 
X’0001' Receive Level is greater than the maximum 
measurable value (-4) as shown in BRFLDBNO 
X‘0002' Receive Level is less than the minimum 
measurable value (-48) as shown in BRFLDBNO 
X‘'0003' Receive Level is within measurable limits as 
shown in BRFLDBNO 


Receive Level in DBm for the local modem (signed 
decimal) 





internal 
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[ee [_veme [ieee | tone [ewe 


Modem Section: (continued) 
BRFLNQUR 
BRFHTCTR 






binary internal Remote modem line quality (0-15) 















Remote modem line hits (0-63). This field is model 
dependent. See relevant pubs for your modem model. 


binary internal 
























BRFRDBIN 





This field indicates whether the Receive Level in DBm for 
the remote modem is within measurable limits. 


binary internal 


Value Meaning 


X’0000’' Not applicable 
X‘0001' Receive Level is greater than the maximum 
measurable value (-4) as shown in BRFRDBNO 
X'0002' Receive Level is less than the minimum 
measurable value (-48) as shwon in BRFRDBNO 
X'0003’ Receive Level is within measurable limits as 
shown in BRFRDBNO 





+20 | BRFROBNO 





internal Receive Level in DBm for the remote modem (signed 


decimal) 
LPDA-2 Section: 
+0 +0 BRFFAIND 















Failure indicator 
X'00’ Not appliable 

X'01’ Modem/probe 

X‘02’ Line 

X’03’ Remote device 

X‘04’ Communications (if unknown) 
‘05’ Modem interface 





| binary internal 


+4 +4 BRFLINK internal 





Type of link 
X‘01’ BSC 
X‘02' SDLC 


Modem Sense Byte 








+2 +2 BRFSENSE 
+3 +3 BRFLSL 
+4 +4 BRFADDR 
+6 +6 BRFTYPE 


binary internal 








binary internal 
EBCDIC 


EBCDIC 


Link Segment Level 



















internal Modem address 








internal Modem type. This field contains the four digit machine 


number. 








+10 | +A | BRFMODEL -EBCDIC 








internal Modem model. This field contains the two digit modem 


model. 
+12 +C - 
+14 +E BRFLOCAL 


Reserved. 





Local Modem Report 
This field is overlayed by the section entitled LOCAL 
AND REMOTE MODEM REPORTS. 


internal 





+36 +24 | BRFRMT binary internal Remote Modem Report 


This field is overlayed by the section entitled LOCAL 
AND REMOTE MODEM REPORTS 
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Local and Remote Modem Reports: 


+0 +0 BRFLO 2 binary 
+2 +2 BRFWLO 2 binary 
+4 +4 BRFIMP 2 binary 
+6 +6 BRFRDBM 2 EBCDIC 
+8 +8 BRFMRDBM 2 EBCDIC 
+10 +A BRFSPEED 6 EBCDIC 
+16 +10 | BRFACTSP 4 binary 
+18 +12 | BRFNETFU 1 EBCDIC 
| 
| +19 +13 | BRFFEAIN 1 
+20 +14 | BRFFEAER 1 binary 
+21 +15 | * 1 
Local Area Network Section: 
BRFLMADR EBCDIC 
BRFRMADR 6 EBCDIC 
BRFROUTI 18 EBCDIC 
BRFUPADR 6 EBCDIC 


BRFDNADR 6 | EBCDIC 








internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 


internal 


internal 


internal 
internal 
internal 
internal 


internal 





Line Quality (0-15) 

Worst Line Quality (0-15) 

Impulse Hit Count 

Receive Level in DBm 

Minimum Receive Level in DBm during last 15 minutes 
Modem Speed (‘FULL ’ or ‘BACKUP’) 

Actual Modem Speed in bits per second 


Network Function 
‘01’X = PRIMARY, 
‘02’X = SECONDARY, 
'03’X = CONTROL, 
‘04'K = TRIBUTARY 


Features Installed 
BIT O — Reserved 
BIT 1 — Reserved 
BIT 2 — Reserved 
BIT 3 — Fan Out Installed 
BIT 4 — Reserved 
BIT 5 — Reserved 
BIT 6 — Reserved 
BIT 7 — Reserved 


Features in Error 
BIT 0 — Reserved 
BIT 1 — Reserved 
BIT 2 — Reserved 
BIT 3 — Fan Out in Error 
BIT 4 — Reserved 
BIT 5 — Modem in Idle State 
BIT 6 — Non Vital Data Lost 
BIT 7 — Base Modem Error 


Reserved 


Local MAC Address 
Remote MAC Address 


Routing Information 
MAC Address of Upstream Member 
MAC Address of Downstream Member 
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Record Type 38 (26) — Network Performance Monitor Statistics —_— 


ey 
Record type 38 is written by Network Performance Monitor (NPM) at user 
specified intervals and contains network statistics. For more information about 
the type 38 record, refer to Network Performance Monitor Problem 
Determination Guide (SH20-6363). 
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( : Record Type 39 (27) — NLDM Response Time 


Record type 39 is written by the Network Logical Data Manager (NLDM). NLDM writes to the 
external log if the Response Time Data function (RTM) or the Network Accounting and - 
Availability Measurement function is active. 


The Response Time Data function writes record type 39 when the COLLECT command with the 
LOG parameter is issued or at session end for an LU attached to a 3274 controller with the RTM 
feature. 


The Network Accounting and Availability Measurement Data function writes record type 39 when 
a session is started, a session ends, or when a RECORD command with the SESSTATS parameter is 
issued. 


The format is: 


LOGRLENG internal Record length 
LOGRSEGD internal Segment descriptor 
LOGRSYSI SVC 83 System indicator 


Bit Meaning When Set 
0-4 Reserved 


MVS/XA 
VS2 
VS1 
oo LOGRRECT binary internal Record type (X‘27') 
( LOGRTIME EBCDIC | SVC83 Time, in hundredth of a second, record was moved to 


external log buffer. 


LOGRDATE EBCDIC | SVC 83 Date record was moved to external log buffer, in the 
form OOYYDDDF where F is the sign. 


LOGRSYID EBCDIC | SMCASID System identification (taken from SID parameter) 
LOGRSUBS EBCDIC | internal Subsystem ID ‘NETV’ 
LOGRSUBT binary internal Record subtype 

1 = COLLECT RTM LOG 

2 = Session end 

3 = Session start 

4 = Accounting and availability data 


5 = Combined 
6 = Bind failure 
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LHRDRPRDO 
LHDRPRDL 
LHDRPRDN 
LHDRSESO 
LHDRSESL 
LHDRSESN 
LHDRRTEO 
LHDRRTEL 
LHDRRTEN 


LHDRRTMO ~ 


LHDRRTML 
LHDRRTMN 
LHDRACCO 
LHDRACCL 
LHDRACCN 


4 
2 
2 
4 
2 
2 
4 
2 
2 
4 
2 
2 
4 
2 
2 


binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 


binary 
binary 
binary 


BINARY 
BINARY 
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internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 


Offset of product section 

Length of product section 

Number of product sections 

Offset of session configuration section 

Length of session configuration section 

Number of session configuration sections 

Offset of route data section 

Length of route data section 

Number of route data sections 

Offset of response-time data section | 

Length of response-time data section 

Number of resonse-time data sections 

Offset of accounting and availability data sections 
Length of accounting and availability data sections 


Number of accounting and availability data sections 





Note: The offset fields of this section are the offsets of the data areas from the beginning of log record. 





ee 


Product Section: 


LPRDSUBT 


LPRDVERN 


LPRDNAME 





EBCDIC 


EBCDIC 





internal 


internal 


internal 


Record subtype 


1= COLLECT RTM LOG 

2 = Session end 

3 = Session start 

4 = Accounting and availability data 
5 = Combined 

6 = Bind failure 


Product version and release 
X'0001’ - NETVIEW C1.1 


Product name — “"NETY” 


Note: LPRDSUBT is the same as LOGRRECT in Log Record Header Section. 
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Session Configuration Data Section: 


+0 0 

+2 2 

+10 A 

+18 12 
+26 1A 
+34 22 
+42 2A 
+50 32 
+58 3A 
+66 42 
+74 4A 
+82 52 
+90 5A 
+98 62 
+100} 64 
+102] 66 
+104| 68 
+106] 6A 
+114] 72 
+115} 73 
+116] 74 


LSESREVL 


LSESPNAM 
LSESPPUN 
LSESPLNK 
LSESPSAP 
LSESPDOM 
LSESSNAM 
LSESSPUN 
LSESSLNK 
LSESSSAP 
LESSSDOM 
LSESPCLS 
LSESCOST 
LSESERN 
LSESRERN 
LSESVRN 
LSESTPF 
LSESPCID 
LSESTYPE 


LSESXNET 
LSESCODE 


2 


Oo YO NY NM NH CO CO CO CO © © O © CO WH CO OH 


—_ 


binary 


EBCDIC 


~EBCDIC 


EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 


| EBCDIC 


EBCDIC 
EBCDIC 
binary 
binary 
binary 
binary 
binary 
EBCDIC 


EBCDIC 
binary 


VTAM 


VTAM 


VTAM 
VTAM 
VTAM 
internal 
VTAM 
VTAM 
VTAM 
VTAM 
internal 
internal 
VTAM 
VTAM 
VTAM 
VTAM 
VTAM 
VTAM 
VTAM 











Description 


Note: If data is not available LSESPPUN, LSESPLNK, and LSESPSAP contain ‘00’x. If data is not available 


LSESERN, LSESRERN, LSESVRN and LSESTPF contain ‘FF'X. 
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a 

Revision level: NLDMVIR2 1 

NLDNVIR3 2 
Primary logical unit (PLU) name 
Primary physical unit (PU) name. 
Primary link name 
PLU subarea physical unit (PU) 
PLU domain name 
Secondary logical unit (SLU) name 
Physical unit (PU) name for SLU © 
Name of the link for the SLU 
SLU subarea PU 
SLU domain name 
Performance class name 
Class of service 
Explicit route number 
Reverse explicit route number 
Virtual route number 
Transmission priority 
Unique session 1D (PCIDARSI) | 
Session type | : ‘ 
1 = LU-LU Ne 
2 = SSCP-LU 
3 = SSCP-PU 
4 = SSCP-SSCP 
Cross network session (Y or N) 
bind failure or unbind reason code | 

eY 














Route Data Section: 


source | Deserntiom 






+0 0 LRTEREVL 2 binary internal Revision level: 1 

+2 2 LRTENUME 2 binary internal Number of route elements 

+4 4 | LRTENUMT 2 binary internal Number of route elements in table. 
+6 | 6 | LRTEETAB! 0 Route test Route element table 





For each route element, there is a ten-byte entry with the following format: 





+0 0 LRTEENAM 8 binary internal Route element name 








+8 8 | LRTEETGO 2 binary Route test Transmission group (out) number 





Response Time Data Section: 













LRTMREVL 
LRTMCOLB 
LRTMCOLE* 
LRTMOBJP 
LRTMOBJB 
LRTMDEF 
LRTMOBJF 
LRTMTRAN 
LRTMTOTT®? 
LRTMBNDS 


internal Revision level: 1 










binary 














binary internal Collection period begin time stamp 











binary internal Collection period end time stamp 
















binary internal Objective — percentage 





internal Objective — counter number 





binary 
EBCDIC 
EBCDIC 











internal Response time definition 








internal Objective — Y=met N=not met 
RTM Feature’ 


RTM Feature” 













Number of transactions measured 






binary 














binary Total response delay 













Four four-byte fields containing counter 
boundaries 


binary internal 









LRTMBKTS® RTM Feature * Five four-byte fields with contents of 


counters 


binary 












LRTMOBJT 





binary internal Objective — response time 





; LRTEETAB is an array of structures. LRTEENAM and LRTEETGO are fields in the structure. 


ze or LRTMCOLB and LRTMCOLE, the first four bytes of time stamp are the local time in STCK format, the last four are the 
local time in STCK format, the last four are the conversion factor from GMT to local time. (Example: 982B5412 FFFFCASB). 


3_RTMB KTS and LRTMTOTT are in tenth-of-seconds. 


AT he data is allocated by the RTM Feature of the PU. 
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ff 
Wy 
Accounting and Availability Data Section: 
+0 LACCREVL 2 binary internal Revision level: 2 
| +4 LACCBEGT 8 binary internal Collection period begin time stamp 
LACCENDT 8 binary internal Collection period end time stamp 
LACCPCBC 4 binary internal Number of control PIUs sent from primary to secondary 
LACCPCCC 4 binary internal Number of control bytes sent from primary to secondary 
LACCSCBC 4 binary internal Number of contro! PIUs sent from secondary to primary 
LACCSCCC 4 binary internal Number of control bytes sent from secondary to primary 
LACCPTBC 4 binary internal Number of text PIUs sent from primary to secondary 
LACCPT CC 4 binary internal Number of text bytes sent from primary to secondary 
LACCSTBC 4 binary internal Number of text PIUs sent from secondary to primary 
LACCSTCC 4 binary internal Number of text bytes sent from secondary to primary 
Notes: 
1. For LACCBEGT abd LACCENDT, the first four bytes of the time stamp are local time in STCK format. The last four bytes 
are the conversion factor from GMT to local time. (Example: 982B5412 FFFFCASB). 
2. The Network Logical Data Manager (NLDM) uses the indicators in the first byte of the RH to select control and next PIUs. 
3. The number of bytes counted are data bytes only. 
4, BSC connections do not have contro! PiUs. 
i 




















Record Type 40 (28) — Dynamic DD 


Record type 40 is written by IEFDB4F9 when an unallocation, concatenation, or 
deconcatenation request is processed. For an unallocation request, this record 
contains a device entry only for the data set unallocated. For a concatenation or 
deconcatenation request, this record contains a device entry for each DD entry in 
the TCTIOT. Its length is 66 bytes plus eight bytes for each device entry. 


Record type 40 contains the job log identification, user identification, step 
number, functional indicator, and device entries. Each device entry consists of the 
device class, unit type, device number, and EXCP count for the data set. 


set. 


Note: For more information on EXCP count and CPU time, see Chapters 8 and 9, 
respectively. 


The format is: 


Coreen [nme [uma Fomet [Soren =o 
fo [o | roonten [2 [inary [in| Rea een 
[a [a | roonsee [2 [iron [inert | somtdewipor 


TDDRFLG binary SVC 83 System indicator 
=) Meaning When Set 
Reserved 
MVS/XA 
VS2 
Reserved 


TDDRCDTY | 1 | binary | binary internal Record type 
- TDDRCDTS binary SVC en Time, in hundredths of a second, record was moved to 
SMF buffer 


-TDDRCDTE packed {| SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
TDDOCPUID ) 4 | eBcoic, ) EBCDIC| |JMRCPUID | System identification (taken from SID parameter) 
oc ToouiF =| 8 | EBCDIC| JMRJOB Job name? 


TDDONTME binary JMRENTRY Logon time, in hundredths of a second (1 background job, 
this ee contains the time the reader recognized the JOB 
card. a 

TDDONDTE packed | JMREDATE Logon date, in ‘the form OOY YDDDF where F is the sign. 
(If background job, this ae contains the date the reader 
recognized the JOB card. )} 

iat sd TDDUDATA Hci Halli EBCDIC| JMRUSEID User identification (taken from common exit parameter 

"|" - 


|_ToDINvSA | 4 | binary — |JMRSTEP | Step number (first step=1,ete) number (first step = = 1, etc.) 


-TDDF LG binary Functional indicator 
Value Meaning 
2 Unallocation 
3 Concatenation 
4 Deconcatenation 


the job name and the time and date that the reader recognized the JOB card for this job constitute the job log 
identification. 
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[ots [Name [eaves [Forme [Source «SSC arnt 


2C TDDRIN binary Record indicator 
Bit (Meaning When Set 
| | 0-6 Reserved 
TCTIEX 7 EXCP count may be wrong 
| 8-25 Reserved 


[as [= | TooRva 


TDDOVAR binary Length of device entry portion of this record. Calculated as: 
(8 times the number of devices) + 2 


For each device, there is an eight-byte entry with the following format:° ; 


. +0 TDDDEVC 1 binary | UCBTBYTS3 Device class 
+1 | TDDUTYP 1 binary | UCBTBYT4 Unit type 
+2 TDDCUAD 2 binary UCBCHAN Device number 
| +4 TDDNExce | 4 Ibinary | TcTDCTR EXCP count (see offset 44)? 


2if a GETMAIN for expanding the TCTIOT (the data area where EXCPs are maintained) fails, only 
the existing data sets are counted. If the functional recovery routine is entered, EXCP counting for 
the step is discontinued and no device entries are produced. If ADDRSPC=REAL is specified, the 
EXCP count does not include PCls. After a Dynamic Concatenation or Deconcatenation all EXCP 
counts are zeroed; therefore, the EXCP count in subsequent type 40 records will not reflect the total 
EXCP count for the step. This information is available in the type 30 record. For more information 
on EXCP count, see Chapter 8. 


3The device entry is zero when the DD entry is TERM, DUMMY, or unallocated DYNAM. (A DD 
DUMMY entry also results when a forward reference to a DD statement having that DD name is not 
found.) Entries for virtual |/O data sets are zero for class type, and X'7FFF' for device number. If 
the high order bit is on in the device number field, a virtual device is indicated. 
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Record Type 41 - Data-In-Virtual ACCESS/UNACCESS Record 





Record type 41 provides resources usage information regarding a Data-In-Virtual 
object. This record is written by the Data «In-Virtual user exit at the time a 
Data-In-Virtual object is ACCESSed and at the time the object is 

UNACCESSed. 


Record type 41 contains the object ACCESS, Object UNACCESS and object 
I/O Activity data sections. The object ACCESS data section contains time of 
day the ACCESS occurred, DD-name of the object, object size at the time of 
ACCESS, object type and the mode of ACCESS (read or update). The object 
UNACCESS data section contains the time of day the UNACCESS occurred, 

the size of the object at UNACCESS time and I/O activity counts accumulated 
while the object was in use. The object I/O Activity data section contains total 
reads, writes and re-reads performed on the object as well as the total number of 
read requests and write requests made for the object. These counts are 
accumulated by Data-In-Virtual while the object is in use and are reported at the 
time of the UNACCESS request. 
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The format is: 


Offsets 


Length 
2 
2 


SMF41LEN 
SMF41SEG 
SMF41FLG 


binary Record length 


binary Segment descriptor 


binary System indicator 


Meaning When Set 
internal Subsystem ID follows sytem ID 
internal Subtypes utilized ; 


Reserved 
SVC 83 ; MVS/XA 
SVC 83 VS2 

Reserved 


Record type 41 (hex 29) 





SMF41IRTY 
SMF41TME 


internal 
SVC 83 
SVC 83 
EBCDIC] SVC 83 
EBCDIC 


binary 


4 binary Time, in hundredths of a second, record was written 


packed Date record was written by SMF (Julian notation - 0O0yydddf) 


” 


MF41SID 
MF41SSI 
MF41STY 


System identification (taken from SMCASID) 
Subsystem identification (EBCDIC blanks) 
Record subtype (= 1 for ACCESS, = 2 for UNACCESS) 


” 


internal 
2 
2 
2 


binary internal 


binary internal 


—_ ~2 oe AAS NO 


Number of triplets 


> 


SMF41XXX 
MF410PD 
MF41LPD 
MF41NPD 
SMF410D1 
MF41LD1 
MF41ND1 
MF410D2 
MF41LD2 
MF41ND2 
MF410D3 
SMF41LD3 
SMF41ND3 


binary internal Reserved 


?) 


binary internal Offset to product section 


2 internal. 
2 


4 


binary Length of product section 


~” 


internal Number of product sections 
Offset of object ACCESS data section 


Length of object ACCESS data section 


binary 
binary internal 


binary internal 


” 


binary internal Number of object ACCESS data sections 
Offset of object UNACCESS data section 
Length of object UNACCESS data section 


Number of object UNACCESS data sections 


binary internal 


binary internal 


” 


binary internal 


” 


binary internal Offset of 1/O activity section 


binary internal Length of I/O activity section 


n n nln n|n 7) 
= = 
aL nT 
& £ 
—_ an 
— 0 
B.) 4 
0 m 
Serre orereriyrty ere 


oO oO > PPTWOLOPOTNOTNOTDNO TNT] - | = No 
© NO a OTO;RINTO OT, BTM] oO] BI] oO 


GDF © 1G 10 | GO] MT M ERM TNR ER ER 
plolAITNITOLOlL pla aRI RIO 
wn 


Number of 1/O activity sections 


internal 


binary 
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| 
i 
I 
| 


fo 
ae, 











C 












Tories [nome [uso] Forme [sauce [SC pnow 


Product Section (present for record subtypes 1 and 2): 
+0 +0 SMF41PL 8 EBCDIC] internal Product level (‘JBB2220’) 
+8 SMF41PN 16 | EBCDIC Product name (‘DATA-IN-VIRTUAL’) 


Object ACCESS Data Section (present for record subtypes 1 and 2): 
+0 +0 SMF41DDA 






EBCDICT] internal Object DDNAME 


g 
1a [oe] suraraza [4 [ine [inerat” | ~onjcteie whan ACOESSed nie fbi 
+17 ACCESS mode (1 = READ, 2 = UPDATE) 


Object UNACCESS Data Section (present for record subtype 2 only): 


+0 +0 SMF41UZU 4 binary internal Object size when UNACCESSed (units of blocks) _ 


SMF41UTU } 4 | binary | internal Time the object was UNACCESSed (hundreths of a second) 
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internal 





Total reads, including re-reads (number of blocks 
read from object) 


SMF41BWR 4 binary internal Total writes (number of blocks written 
to object) 

SMF41BRR binary internal Total re-reads (number of blocks re-read 
from object) 


binary 





SMF41NC Total 1/O calls for reads 
10 SMF410UC Total I/O calls for writes 
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Record Type 43 (2B) — JES2 Start 


Record type 43 is written by HASPINIT when an S JES2 command (to start JES2) 

is issued, and by HASPMISC when a $E SYS command (to reclaim the job processing 
that was being done on the named system in a Multi-Access Spool complex) 

is issued. This record contains a start/warm start indicator, JES2 start options, and 
the identification of the system whose job processing is to be reclaimed. Its length 

is 32 bytes. | 


Record type 43 is also written by VS Personal Computing (VSPC) Program Product 
(5740-XR6). For more information on how VSPC uses this record, see VSPC 
Installation Reference Material, SH20-9205. 


Use IFASMER to generate the JES2 record type 43 macro mapping. For more | 
information, see “Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 


SMF43FLG binary |SVC 83 System indicator — 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
6 VS2 
7 Reserved 





{5 | 5 | sMrasATy | 1 [binary | internal | Record type 


SMF43TME binary | SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

SMF43DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 


'14 | & | smrFassip | 4 | EBCDIC| SMCASID System identification (taken from SID parameter) 


| 18 | 12 | sMF4ssBs | 2 | binary | internal  ——_|_Subsystem identification — X‘0002' signifies JES2 


[20 [v4 | swrasnsv [2 [eine [id Rem 


| 22 | 16 | SMF43LRR | 2 [binary | internal = Length of rest of record, excluding this field 


[2a [1a | smrasnvi| 2 [binery | 


1A. SMF43RST binary so Start/warm start indicator 
Bit Meaning When Set 
0 if O, record written for S JES2 command. 
If 1, record written for $E SYS command 
(see offset 24). 
1-7 Reserved 


$OPTSTAT (in HCT) | JES2 start options. (This field is zero for $E SYS 
command.) 


Bit | Meaning When Set 
Format the spool 
Cold start 
Request automatic initiator 
List replacement card option 
Reserved 









If $E SYS command, identification of system whose job | 
processing is to be reclaimed (see offset 26). 
If S JES2 command, zero. 






aye} met -_ . 
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| 





pe 43 (2B) — JES3 Start 


Record type 43 is written by IATINIK during JES3 and the converter/interpreter 
functional subsystem (C/I FSS) initialization. This record contains an indicator for the 
type of JES3 start, JES3 initialization deck origin type and contents, and JES3 procedure 


name. Its length is 54 bytes. 


The format is: 


Offsets 
~ SMF43LEN binary Record length 
SMF43SEG binary Segment descriptor 


=) 


"4 


slo 


SMF43RTY 


iw SMFE43TME 
A SMF43DTE 


when 
[4 swraansv_ 
Pre [ smraanve 


SMF43RST 


SMF43US1 


SMF43NMU 


i 7 7 


38 26 SMF43PJ3 


2A | SMF43RVJ i ee 
smFasnvu| 4 


2 
2 
2 
2 
1 
1 


NO} pd np NTNME rm] bp 


1) 
Oo 


zs 
| 2 
2 
bie! 
oe 
binary 


4 
: 
4 





SMF43FLG binary |SVC 83 System indicator 
Bit Meaning When Set 
0-5 Reserved 
| 6 VS2 
7 Reserved 


binary |SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 

EBCDIC | SMCASID System identification (taken from SID parameter) 


binary Subsystem identification — X‘0005’ signifies JES3 | 


binary Length of rest of record, excluding this field 




























Set by IATINGL JES3 start record indicator (taken from operator's response 


during DSI; to WTOR macro) 
otherwise, set Bit | Meaning When Set 
Py TAINS Cold start | 


0 

1 Warm start 

2 Hot start 

3 Start is with JES3 queue analysis 

4 JES3 global processor. This bit is always set if start 
is a cold start or warm start. 

5 JES3 local processor. This bit is always set if start 
is a hot start. 

6 Reserved 

7 Dynamic system interchange (DSI) was invoked by 
operator to convert a local processor to the global 


processor. Bits 2 and 4 will also be set. 





binary 


User flags 


JES3 initialization deck origin type (taken from operator’s 
response to WTOR macro) 


EBCDIC | Set by IATINGS JES3 initialization deck origin location (taken from 
operator's response to WTOR macro) 


EBCDIC | Set by IATINGS 





Type Contents Location 


Member name JCL in JES3 procedure 
Member name Data set in JES3 procedure 
Unit address Unit at specified address 





ERBCDIC! SSCTSNAM 


—< a 6 ww www het 


in |EFJSCVT; 
Set by IATINGL 


jbinary | | Reserved foruser 
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Record Type 45 (2D) — JES2 Withdrawal 


Record type 45 is written by HASPNUC when a $P JES2 command (to withdraw 
JES2 from the system) is issued. It is also written at the abnormal termination of 
JES2 if JES2 retains control long enough to write the record. This record contains 


a termination indicator and JES2 completion code. Its length is 28 bytes. 


Record type 45 is also written by VS Personal Computing (VSPC) Program 
Product (5740-XR6). For more information on how VSPC uses this record, see 
VSPC Installation Reference Material, SH20-920S. 


Use IFASMEFR to generate the JES2 record type 45 macro mapping. For more 
information, see “Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 















































| SMF45FLG binary System indicator 

Bit Meaning When Set 

Reserved 

/5 | 5 | SMF45RTY| 1 [binary | internal Record type 7 
OOY YDDDF where F is the sign 

ak eee internal Subsystem identification — X‘0002’ signifies JES2 
0 if 0, record written for $P JES2 command (JES2 

withdrawal). 


J ortews | name | Length [Format | source | Description 
0-4 Reserved 
ST Mees Hi snack Time, in hundredths of a second, record was moved to 
Pas SMF45LRR | 2 [binary | internal Length of rest of record, excluding this field 
If 1, record written for abnormal JES2 termination. 


oa SMF45LEN | 2 | binary | a —— Record length 
5 MVS/XA 
SMF buffer 
binary j internal Termination indicator 
1-15 Reserved 


[—swrasses [2 [binary 
: VS2 
Date record was moved to SMF buffer, in the form 
| | sMFassio | 4 | EBCDIC| SMCASID 
Bit Meaning When Set 
[2s [ia | surasice | 2 [binary _ 





internal 
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Record Type 45 (2D) — JES3 Stop f } 


Record type 45 is written by IATINTK during JES3 and the converter/interpreter 
functional subsystem (C/I FSS) termination. This record contains an indicator for 
the type of JES3 stop, and JES3 completion code. Its length is 42 bytes. 


_ The format is: 


| | SMF4S5LEN | 2 | binary | internal Record length | 


SMF45FLG binary | SVC 83 System indicator | 
| Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
6 VS2 
7 Reserved 






SMF45RTY binary | internal Record type 


SMF45TME 4 
| | | SMF buffer 
A SMF45DTE 4 packed | SVC 83 _ Date record was moved to SMF buffer, in the form 
i | | OOYYDDODF where F is the sign 
ae 
24 


binary {|SVC83 Time, in hundredths of a second, record was moved to 


Te | surassio | «| 


EBCDIC] SMCASID System identification (taken from SID parameter) 
| 12 | SMF45SBS binary | internal Subsystem identification — X’0005' signifies JES3 
SMF45RSV 


binary | internal Length of rest of record, excluding this field : ; 


Set by IATINTK | JES3 stop record indicator Na” 
Bit Meaning When Set 


0 JES3 or the C/I FSS abnormally terminated (taken 
from completion code in ECB) 

1 Dynamic system interchange was invoked by 
operator to convert a local processor to the 
global processor 

2-7 Reserved 


SMF45LRR 
Set by IATINTK | JES3 completion code (taken from completion code in 
ECB) where bits 0-11 represent a system code and bits 
12-23 represent a user code. Note that the JES3. 


; SMF45FG1 
completion code, as recorded on the operator’s console, 


| 19 SMF45J3C 3 binary 
is always S 2FB. 
Lae 


binary 


binary 


30716 | swraervs 
[se [26 [swresavu 


binary 
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Record Type 47 (2F) — JES2 SIGNON/Start Line (BSC only) 


Record type 47 is written by HASPRTAM when (1) a $S LNEn command (to 
start a line) is issued, (2) a $E LNEn command (to restart a line) is issued, and (3) 
a remote user signs on. This record contains a record indicator, remote name, line 
name, password, and message text. Its length is 52 bytes for a $S LNEn command 
and 90 bytes for a SIGNON record. 


Record type 47 is also written by VS Personal Computing (VSPC) Program Product 
(5740-XR6). For more information on how VSPC uses this record, see VSPC 


Installation Reference Material, SH20-9205. 


Use IFASMFR to generate the JES2 record type 47 macro mapping. For more 
information, see ‘““Using the IFASMFR Macro to Address SMF Record Fields’’ in 
Chapter 4. 


The format is: 


Pe Tf aera 2 fe ems Record length 


SMF47FLG binary | SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
MVS/XA 
VS2 
Reserved 


(5 [5 | smra7ATY| 1 [binary internal __| Record type 


SMF47TME binary {SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
10 A SMF47DTE packed {SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


| 14 | E | SMF47SID | 4 | EBCDIC} SMCASID System identification (taken from SID parameter) 


“Oo 01 








binary Subsystem identification — X'0002’ signifies JES2 





Length of rest of record, excluding this field 


} 20 | 14 | SMF47RSV binary 
Record written for $S LNEn command 


SMF47EVT binary 
_ Record written for SIGNON 


14 
15 
tet ae Section: 
tet ae F47LN1 iy. Se Length of identification section, including this field 
SMF47RMT [* EBCDIC | RATNAME Remote name. (This field is filled in only if a remote 









Record indicator 


Bit Meaning When Set 
0-13 Reserved 














terminal is connected to this line.) 


[36 24 | SwFA7LIN | 8 |EBCDIC| DCTDEVN 
SMF47PSW <a EBCDIC|MDCTPSWD (in DCT)| Password 


The following fields apply when a remote user signs on: 











rg Section: 
SMF47LN2 internal Length of rest of record, including this field 


54 SMF47MSG EBCDIC] SIGNON record Message text. This field includes columns 35-70 of the 
SIGNON card image. 
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Record Type 47 (2F) — JES3 SIGNON/Start Line/LOGON 


Record type 47 is written by IATSNDT when a system network architecture (SNA) 
remote user logs on or by IATRJM3 when a binary synchronous communication 


(BSC) remote line is started or a BSC remote user signs on. 


For SNA, the record contains a record indicator, a work station name, a logical 


unit (LU) name, and a password. The record length for a SNA log on is 52 bytes. 


For BSC, the record contains a record indicator, a remote name, a line name, a 


password, and, for a remote sign on, a message text. The record length is 52 bytes 


for a started line or 102 bytes for a sign on. 


The format is: 


Orme [Nene [Leet] Format | Some 
To | swrarcen | 2 [binary | inereat 
2 [2 | swrarsec [2 [binary | inernas | 


SVC 83 


internal 


inary SVC 83 
SVC 83 


BCDIC | SMCASID 


internal 


oO 


binary 


SMF47RTY 


SMF47TME 
SMF47DTE 


Tswra7ses [2 
ae 
= 


SMF47FLG 


inary 


oO 


o;jm 


inary 
SMF47RSV 
SMF47LRR binary 


7 
18 | SMF47EVT ey 


binary 
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jf 


cked 


t 





Description 
Record length 
Segment descriptor 
System indicator 


Bit Meaning When Set 


0-4 Reserved 
5 MVS/XA 


6 VS2 
7 Reserved 
Record type 


Time, in hundredths of a second, record was moved to 
SMF buffer 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


System identification (taken from SID parameter) 
Subsystem identification — X’0005’ signifies JES3 
Reserved 

Length of rest of record, excluding this field 
Record indicator 

Bit Meaning When Set 

0-12 Reserved 


13 Record written for SNA LOGON 
14 Record written for BSC started line 


15 Record written for BSC SIGNON 








oN 


ee 
Bo” 


A | oN 
fone : 
nd. / 









Identification Section 
26 1A SMF47LN1 


7 SME47LIN 
44 


2 


SMF47RVU 


7 ae Length of identification section including this field 


EBCDIC }| IATRJM1 for line, | Remote name. (This field is filled in only if a remote 


IATRJM3 for terminal is connected to this line.) 
EBCDIC 















_SIGNON 


'WATSNDT for 
LOGON 


{ATRJM1 for line, 
IATRJM3 for 
SIGNON 


IATSNDT for 
LOGON 







Work station name 










Line name 














LU name 










Length of message section, including this field 


E SIGNON record Message text. This field includes columns 35-70 of the 
SIGNON card image. 
Reserved for JES3 
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Record Type 48 (30) — JES2 SIGNOFF /Stop Line (BSC only) 


Record type 48 is written by HASPRTAM when (1) a $P LNEn command 

(to stop a line) is issued, (2) a $E LNEn command (to restart a line) is issued, and 
(3) a remote user signs off. This record contains a record indicator, remote name, 
line name, password, line adapter address, and the number of EXCPs, negative 


acknowledgements to write text, data checks to read text, and time outs to read 
text. Its length is 75 bytes. 


Record type 48 is also written by VS Personal Computing (VSPC) Program 
Product (5740-XR6). For more information on how VSPC uses this record, 
see VSPC Installation Reference Material, SH20-9205. 


Use IFASMER to generate the JES2 record type 48 macro mapping. For more 
information, see ‘““Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 


[ores [Name [teva] Foret | Sows [SC metnton 
Exal 


SMF48LEN binary Record length 
5 MVS/XA 
SMF48DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
SMF48EVT binary Record indicator 
15 Record written for SIGNOFF 


(2 [2 | surassec 
6 VS2 
sok his Reaenit SMF48SID | SMF48SID | 4 | EBCDIC}] SMCASID System identification (taken from SID parameter) 
Bit Meaning When Set 
SMF48RV1 binary 
































0-4 Reserved 
SMF48TME binary | SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
| 22 | 16— SMF48LRR | 2  |binary jinternal Length of rest of record, excluding this field 





SMF48FLG binary | SVC 83 System indicator 
Reserved 
aks SMF48SBS |} 2 [binary | Subsystem identification — X'0002' signifies JES2 
0-13 Reserved 


Bit Meaning When Set 
[“swraantv [1 [binary [inernat | Record type SSCS 
[20 | 14 [| SMF4gRsv| 2 [binary [| ss Reserved —“‘CSs™s*stsS 
14 Record written for $P LNEn command 
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[wens [nats Forme | sowee [Rainn 
1c SMF48RMT RATNAME Remote name. (This field is filled in only if a remote 
terminal is connected to this line.) 
[36 | 26 [| SMrasuin | 8 | escDIc| DGTDEVN 
Gaal il OG a 
(in DCT) 
SMF4810 binary MDCTSXCP or EXCP count 
MDcCTxcpP2 
SMF48NAK binary | MDCTSNAK Number of negative acknowledgements to write text | 
or MDCTNAK2 | 
honk does SMF48DCK. BA wad MDCTSDCK : Number of data checks to read text 
or MDCTDCK 
ol a SMF480UT Oe ck MDCTSTO , Number of time outs to read text . 
or MDCTTO 
44 | SMF48ERR binary | MDCTSREM Sum of all other line errors 
or MDCTREM?} 





1The field names beginning with MDCTS are for SIGNOFF and contain session totals » the 
other fields are for $P LNEn commands and contain connection totals. 
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Record Type 48 (30) — JES3 SIGNOFF /Stop Line/LOGOFF —_ 


Record type 48 is written by IATSNLC when a system network architecture (SNA) 
remote user logs off or by IATRJM4 when a binary synchronous communication _ 
(BSC) remote line is stopped or a BSC remote user signs off. 


For SNA, the record contains a record indicator, a work station name, a logical 

unit (LU) name, a password, and a line I/O count. The record length is 68 bytes. 
For BSC, the record contains a record indicator, a remote name, a line name, a 
password, a line adapter address, and line I/O counts. The record length is 95 bytes. 


Note: For BSC, the statistics in this record are accumulated for the line from 
SIGNON/LOGON to SIGNOFF/LOGOFF. 


The format is: 


a 
SMF4SLEN binary Record length 


SMF48FLG 1 binary SVC 83 System indicator 


Bit Meaning When Set 
0-4 Reserved 


Len 


Offsets — 


i 


Name 


4 


5 MVS/XA 


6 VS2 
7 Reserved 


binary Record type aN 


binary SVC 83 Time, in hundredths of a second, record was moved to .- Seg 
SMF buffer —% 
packed SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
EBCDIC | SMCASID System identification (taken from SID parameter) 
binary Subsystem identification — X‘0005’ signifies JES3 


bingy [Reve 
binary Length of rest of record, excluding this field 


binary Record indicator 
Bit Meaning When Set 


0-12 Reserved 

13 Record written for SNA LOGOFF 
IATRJM4 Record written for BSC stopped line 
IATRJM4 Record written for BSC SIGNOFF 





SMF48RTY 
SMF48T ME 


a. 


A SMF48DTE 


SMF48SID 
SMF48SBS 
SMF48RSV 
SMF48LRR 
SMF48EVT 


N 
f& 


N 
N 


2 
2 



















IATSNLD 






A SMF48RV1 












C SMF48RMT EBCDIC | I|ATRJM4 Remote name. (This field is filled in only if a remote 
for BSC terminal is connected to this line.) 
IATSNLC Work station name 
for SNA 


SMF48LIN EBCDIC |; IATRJM4 Line name 
for BSC 
IATSNLC LU name 


for SNA 


26 SMF48PSW 8 EBCDIC | IATRJM4 Password 
for BSC 
IATSNLC 
for SNA 


o 





s] | be 





SMF48TRN IATRJM4 EXCP count 
for BSC 
IATSNLC SEND count 
| for SNA 
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SM F48ERS binary IATRJM4 Number of line errors 
for BSC 
1 1ATSNLC RECEIVE count 
| for SNA 
SMF48TOT binary IATRJM4 Number of time outs to read text 
| for BSC 
IATSNLC SEND negative response count 
for SNA 
SMF48NKS binary IATRJIM4 Number of negative acknowledgements to write text 
| for BSC 
| iIATSNLC RECEIVE negative response count 
| for SNA 
| SMF48S0 binary IATRJM4 Number of command rejects 
, for BSC 
| IATSNDM SEND positive response count 
| for SNA 


| 
| smrassi1 | 1 | binary | IATRUM4 Number of interventions required 


! SMF48S2 binary | IATRJM4 Number of bus-out checks 

| for BSC | 

i IATSDR RECEIVE positive response count 
| for SNA 

| SMF38S3 IATRJM4 Number of equipment checks 


a = fields apply aes to BSC: 
SMF48S4 nen \ATRJM4 Number of data checks 


Pf [sere [an TRAE | Wee 
¢ ee SSS a 


| a3 | § SMF48RVJ ae ee Reserved for JES3 


1For SNA, adjust offsets to account for the increased length. 


66 42 SMF48S1 
67 43° SMF48S2 
69 45 #$SMF48S3 
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Record Type 49 (31) — JES2 Integrity (BSC only) (c ‘ 









Record type 49 is written by HASPRTAM when a remote user attempts to sign on 
with an invalid password. This record is the same as record type 47 except the 
password is invalid. It contains a record indicator, remote name, line name, invalid 
password, and message text. Its length is 90 bytes. 
Record type 49 is also written by VS Personal Computing (VSPC) Program . 
Product (5740-XR6). For more information on how VSPC uses this record, 
see VSPC Installation Reference Material, SH20-9205. 
Use IFASMER to generate the JES2 record type 49 macro mapping. For more 
information, see ‘“Using the IEFASMFR Macro to Address SMF Record Fields”’ in 
Chapter 4. | 
The format is: | | 
[offs [Nowe [uevath] Forme | Sowse [——~—~—Cimeton 
[lo [eo | swreocen [2 [binary [imernat | Recordimath 
| SMF49FLG [binary | SVvC83 System indicator 
Bit Meaning When Set 
: 0-4 . Reserved 
5 MVS/XA 
6 VS2 
7 Reserved — 


| | SMF49TME 
10 | A | SMF49DTE 
| SMF49sBs 


binary |SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 


packed {SVC 83 Date record was moved to SMF buffer, in the form , 
| OOYYDDDEF where F is the sign . 
EBCDIC | SMCASID System identification (taken from SID parameter) 


| Subsystem identification — X'0002’ signifies JES2 


internal Length of rest of record, excluding this field 


binary Record indicator 
Bit Meaning When Set 
0-13 Reserved 
Length of identification section, including this field 
EBCDIC] RATNAME Remote name. (This field is filled in only if a remote 
terminal is connected to this line.) 
internal Length of rest of record, including this field 
EBCDIC N record iViessage text. This field includes columns 35-70 of the 


14 Started line 
ten bed We i] 
SIGNON card image. 


4 SMF49RSV 


16 | SMF49LRR 
8 


a 
cS 
—- 
| 2 
ieee 
wie 
ee 
i 
36 


ee: 
aS 


ree 













| Identification Section: 
14 1 SMF49LN1 


SME49RMT 
SMF49LIN 


2C SMF49PSW 






15 Record written for SIGNON 
EBCDIC} SIGNON record Invalid password 


® Noy NO 


Message Section: 
52 34 SMF49LN2 
541 36 | SMF4gMs 


o 
G) 
a 
2) 
a. 
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( : Record Type 49 (31) — JES3 Integrity 


Record type 49 is written by IATSNLS when a system network architecture (SNA) 
remote user attempt to logon on with an invalid password or by IATRJM3 when a 
binary synchronous communication (BSC) remote line user attempts to sign on 
with an invalid password. 


For SNA, the record contains a record indicator, a work station name, a logical 
unit (LU) name, and an invalid password. The record length is 52 bytes. For BSC, 
the record contains a record indicator, a remote name, a line name, an invalid 
password, and, for a remote sign on, a message text. The record length is 90 bytes. 


The format is: 


[ortats [Name [Lonuth] Format] Sous | ~=~S~*~*~t into 
[2 [inary [internat | Segment descriptor 


2 | 2 | smragsec | 
SMF49FLG binary | SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
: 5 MVS/XA 
6 VS2- 
Reserved 
ee internal 


S| swraonTy | 1 [binary — 


7 
SMF49TME binary | SVC83 Time, in hundredths of a second, record was moved to > 
SMF buffer 
A SMF49DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


EBCDIC] SMCASID System identification (taken from SID parameter) 
SMF49SBS 


Subsystem identification — X‘00085' signifies JES3 
SMFaQRSV 
SMF49LRR 


binary |internal = Length of rest of record, excluding this field 
SMF49EVT 


binary IATRJM3 Record indicator 
for BSC esse 
IATSNLS Value Meaning 
for SNA 1 Terminal not defined (BSC) 
Invalid password (BSC) 
identification Section: 
2 








Line already signed on (BSC) 
26 SMF49LN1 binary | internal Length of identification section, including this field 


Terminal already signed on (BSC) 
1A 
1C SMF49RMT EBCDIC] |ATRJM3 
for SIGNON 
IATSNLS 
for LOGON 











Remote name. (This field is filled in only if a remote 
terminal is connected to this line.) 
Work station name 













Line name 









Session limit exceeded (SNA) 
_ SMF49LIN EBCDIC] {[ATRJM3 
for SIGNON 
lIATSNLS LU name 
for LOGON 


Work station undefined (SNA) 
| 44 | 2C | smeF4opsw | 8 __ | EBCDIC| SIGNON/LOGON Invalid password 


Invalid password (SNA) 
Bind failed (SNA) 

The following fields apply only to BSC: | 

Message Section: 





34 SMF49L 2 binary | internal Length of message section, including this field 


52 
36 SMF49MSG EBCDIC] SIGNON record Message text. This field includes columns 35-70 of the © 
SIGNON card image. 
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Record Type 50 (32) — ACF/VTAM Tuning Statistics 


Record type 50 is written by ISTINCTS to report ACF/VTAM tuning statistics. 
If specified, tuning statistics are collected when a user-specified time interval 
expires. Tuning statistics and the time interval are specified in an option when 
ACF/VTAM is started or its options are modified. 


The format is: 


E a 


r= [arse [=o 


| _ 


| SMFsORTY | 1 [binary econ type 


SMF50TME binary SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

SMFS50DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the ener ere mr aga 


| 4 | epcoic! | SMCASID System identification (taken from SID | _ System identification (taken from SID parameter) 


26 | 1A SNF50DLR | 4 | binary | internal Maximum dump-load-restart requests 










Segment descriptor 


System indicator 


Bit Meaning When Set 
Q-4 Reserved 

5 MVS/XA 

6 VS2 
Reserved 





30 | 1e SMF50CWR | 4 [binary | internal Count of WRITE channel programs 


34] 22 SMFS50CRD | 4 [binary | internal | Count of READ channel programs 
SMF50ATN | 4 | binary | internal Total number of attentions received 
SMFSOATR | 4 [binary | internal Attentions on ending status of READ channel programs 


[so | s2 | emrcoruc | 4 |omery [immma | Number of utbound PIU 


)54| 36 | SMF50BUF | 4 [binary | internal Total number of read buffers used 
ise | 3a | SMFS50SLD | 4 [binary | internal Number of times NCP entered slowdown. 
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Record Type 52 (34) JES2 LOGON/Start Line (SNA only) 


Record type 52 is written by HASPRTAM when (1) a $S LNEn command (to start 
a line) is issued, (2) a $E LNEn command (to restart a line) is issued, and (3) a 
remote user signs on. This record contains a record indicator, remote name, line 
name, password, and message text. Its length is 38 bytes for a $8 LNEn command 
and 62 bytes for a SIGNON record. 


Use IFASMFR to generate the JES2 record type 52 macro mapping. For more 
information, see ‘“Using the IFASMFR Macro to Address SMF Record Fields’’ in 
Chapter 4. 


The format is: 


[orews [none [ume] rormet [owes [SSC nwon 
Ee SMF52LEN 2 Besar Record length 


WSMESZBES L6 2 | viery SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
_MVS/XA 
VS2 
_Reserved 


| 5 | 5 | smrs2Rty | 1 | binary |internal | __Record type 


SMF52TME binary |SVC 83 Time, in hundredths of a second, record was moved 
eee 
ee ee LT ES | emoowonorsmetnmege 

form OOYYDDDF where F is the sign 
|14 | E | smFs2sio | 4 |EBCDIC|SMCcASID | __System identification (taken from SID parameter) 
tet ae ee a 
[20 [14 [| SMrszPRc | 2 | binary internal | __Lengthof product section —SSCSCS~C~*S 
[2216 | SMFs2PAN | 2 | binary [internal | Number of product section 
[24 | 18 | sMFszi00 | 2 | binary internal | Offset to identification section 


/26 | 1A] smF52IDL | 2 | binary |internal | Length of identification section 
(28. | 1c] SMF52IDON | 2 | binary |internal ——__ Number of identification Laer of Rentietion eter | 


Product Section: 


SMF52SUB binary Subtype id, 1 = Record written for LOGON 

a [ee ree 2 = Record written for $S LNEn 
[aa [ a0 | sureaven | 2 | eeebic| ere! | Recardverson number 
ra [Caa | sueeaste 4 —[eeente| inemat | Satepsten nee, 682 
Identification Section: | =| | | 
38 | 26| SMF52RMT | 8 | EBCDIC/RATNAME | __Remotename (only for Subtype id=1) 
[a6 26 | swrs2uin | 8 | eacDic|DCTDEVN | Linereme 
(54 | 36 | smFs2psw | 8 |EBCDIC/MDCTPSND |  Linepassword 
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Record Type 53 (35) JES2 LOGOFF/Stop Line (SNA only) on 


i 





Record type 53 is written by HASPRTAM when (1) a $P LNEn command 

(to stop a line) is issued, (2) a $E LNEn command (to restart a line) is issued 
and (3) a remote user signs off. This record contains a record indicator, remote 
name, line name, password, line adapter address, and the number of EXCPs, 
negative acknowledgements to write text, data checks to read text, and time 
outs to read text. Its length is 85 bytes. 


Use IFASMER to generate the JES2 record type 53 macro mapping. For more 
information, see “Using the IFASMFR Macro to Address SMF Record Fields”’ in 
Chapter 4. 





The format is: 


[oT o | swrsscen [2 [binary [internal 
[2 einary [internal 


2 | 2 | SMFS3sEG | 
TE LEE 
[5 


| 5 | SMFS3RTY | 1 [binary [internal | 


A SMF53DTE packed |SVC 83 Date record was moved to SMF buffer, in the 
form OOYYDDDF where F is the sign 


114 | E | SMF53SID | 4 |EBCDIC|SMCASID | System identification (taken from SID parameter) 
[18 | 12 | swFsspor | 2 [binary internal _—|_Offset to product section 
20 | 14 | smFssPRL_ | 2 [binary |internal__|_Length of product section 
[24 | 18 | smFs3iDo [| 2 [binary [internal — __ Offset to identification section 
/26 | 1A | SMFS3IDL | 2 [binary [internal | Length of identification section 
28 1C | SMF53IDN | 2 [binary Number of identification section 

a 

Ee 

Ea 


Description 











Record length 
Segment descriptor 
System indicator 


Bit Meaning When Set 
0-4 Reserved 


5 MVS/XA 
6 VS2 
7 Reserved 





Record type 
Time, in hundredths of a second, record was 
moved to SMF buffer. 














Product Section: aa 


SMF53SUB binary internal Subtype id, 1 = Record written for LOGOFF 


2 = Record written for $P LNEn 
SMF53VER EBCDIC Record version number 
SMFS3SYS 


EBCDIC 









Subsystem name, ‘JES2’ 
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Identification Section: ia Se (eee 


sFsgnuT | 6 [es0bIC [RATNAME 


| 26 | 
| 2E 
| 36 | 
[orem [+ pe ce 
or MDCTVREQ!1 
SMFS53CTR +4 binary MDCTSCNT + 4 Number of exception responses 
= Py lormoeranget | ecfmemion enone 
70 SMF53CTR +8 binary |MDCTSCNT +8 Number of LUSTAT’s received 
hae a | * Pry [owoeruusrt | “ewettierAreremoed 
| 52 
























or MDETMPER1 


3 __ |EBCDIC Jinternal 


1The field names MDCTSCNT are for LOGOFF and contain session totals; the other fields are for $P LNEn 
commands and contain connection totals. 


SMF53CTR +12 binary MDCTSCNT + 12 Number of bid rejects 
or MDCTBIDR1 


SMF53CTR +16 MDCTSCNT + 16 Number of temporary errors 








SMF53ADP ___Line identifier, ‘SNA’ 
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Record Type 54 (36) — JES2 Integrity (SNA only) 


Record type 54 is written by HASPRTAM when a SNA remote user attempts to 
sign on with an invalid password. It contains a record indicator, remote name, line 
name, invalid password, and message text. Its length is 62 bytes. 


Use IFASMER to generate the JES2 record type 54 macro mapping. For more 
information, see “Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 


SMFS54LEN | 2 |binary [internal 


SMFE54F LG SVC 83 


SMF54RTY internal 


Description 


; Offsets 


Record length 


Segment descriptor 
System indicator 


Bit Meaning When Set 
0-4 Reserved. 


MVS/XA 
VS2 
Reserved 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Data record was moved to SMF buffer, in the 
form OOYYDDDF where F is the sign 


System identification (taken from SID parameter) 
Offset to product section 

Length of product section 

Number of product section 

Offset to identification section 

Length of identification section 





SMF54DTE SVC 83 


EBCDIC | SMCASID 


— 
i 


SMF54S1ID 


SMF54POF internal 


Binary — [internal 
i 


an 
| 2 binary — internal 
Pee 


Number of identification section 


Nit N 
ond 
O 


internal 





Product Section: ae | 
30 | 1E | smrs4suB | 2 internal Subtype id, 1 = Record written for LOGON 
20 SMF54VER Record version number 


EBCDIC | internal 
EBCDIC | internal 


GW iG 
ele 


Subsystem name, ‘JES2’ 


eee 
SMF54SYS_ | 4 | 
Identification Section: a ae 


38_ | 26 | SMF54RMT EBCDIC | RATNAME 
E | SMF54RPW | 8 — |EBCDIC| User’s Logon 
6 | SMF54Psw | 8 — |EBCDIC| User's Logon 


Remote name 


Remote password 


als 


Line Password 
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Record Type 55 (37) — JES2 Network SIGNON Record 


Record type 55 is written by HASPNET at each node when a start networking 
command is executed. The initial SIGNON is recorded at the node to which 
the SIGNON was sent; the response SIGNON is recorded at the node that 
originated the initial SIGNON. Its length is 58 bytes. 


Use IFASMFR to generate the JES2 record type 55 macro mapping. For more 
information, see ““Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 


[offre [ame [Uangth][ Format | Souree TC weriptom 
ro [ro | swesscen [2 [binary | —inernat | Revordiengty 
re [ 2 [ smessses [2 oinery | inerat | sepmenesnepi 


| SMF55F LG SVC 83 System indicator 


Bit Meaning When Set 
0-4 Reserved 
rs | 8 | swrssnty | 1 [binary | internal | Records SSCSC~SCSCS 
a a a i a ee 
moved to SMF buffer 
eA PENT LS Pee Ee | ictmoowooor were eiteign 
the form OOYYDDDF, where F is the sin 
fia | E | swressio | 4 |EBCDIC] SMCASID_ | System identification (taken from SW parameter) | 
ra [ 12 | smesssas | 2 [binary | internal [Subsystem identification X°0002" signifies JES2_— 


Se Tee SMF55LRR | 2 [binary | Length of rest of record, not including this field 



















5 MVS/XA 
6 VS2 
7 Reserved 























SMF55FG1 binary a Sign-On Status Flag: 
1-7 Reserved 


sence] — noaIOO a enna 
ra as Susu [sy] WeSTOU AT 
Bit Meaning When Set 
0 Response sign-on 
(off = initial sign-on) 
[422 | SMFSSLPW | 8 [EBCDIC|  NCCILPAS 
[42_[ 2a | SMFseNPW | 8 [EBCDIC| NCCINPAS 
[so | 32 | smrssinm | 8 [EBCDIC| DCTDEVN 
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Record Type 56 (38) — JES2 Network Integrity Record 


Record type 56 is written by HASPNET whenever an attempt to SIGNON 
contains an invalid line or node password. Its length is 58 bytes. 


Use IFASMER to generate the JES2 record type 56 macro mapping. For more 
information, see “Using the IFASMFR Macro to Address SMF Record Fields’’ in 


Chapter 4. 


The format is: 


[Name [Length] Format 
SMF56LEN | 2 [binary _ Record length 
| 2 [binary — internal Segment descriptor 


SMF56F LG 1 binary SVC 83 System indicator: 


Bit Meaning When Set 
0-4 Reserved 














g 


g 









5 MVS/XA 
6 VS2 
7 Reserved 


SME56RTY | 1 [binary | internal Record type 7 


moved to SMF buffer 
| in the form OOYYDDDF, where F is the sign 
SMCASID 


18 | 12 | smFsesBs | 2 |binary | _ internal Subsystem identification X‘0002’ signifies JES2 
[2o| 14 | smesesue | 2 [binary | internal | Recordsubtype SSS 
22 | 16 | SMF56LRR | 2 |binary | internal Length of rest of record, not including this field 


> 
















SMF56FG1 binary SMFRSPSO Sign-on Status Flag: 
1-7. Reserved 


[24 | 18 | SMF56NNM | 8 |EBCDIC| NCCINODE 
Bit Meaning When Set 
0 Response sign-on 
[aa [22 | swrseipw |e [epcpic| NcciLPas 
(42 | 24 | SMF56eNPW | 8 |EBCDIC| NCCINPAS 


| 1 [binary | NCCIQUAL 
(off = initial sign-on) 
[so | 22 | srse.nm | 8 |escoic| _ocTDEVN 
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tk 
f nt ‘ 














( - Record Type 57 (39) — JES2 Network SYSOUT Transmission Record 


Record type 57 is written by HASPNET whenever JES2 completes a network 
SYSOUT transmission. This record contains original and current job identifiers, 
transmitter start and stop times, and a count of the records transmitted. Its 
length is 104 bytes. 


Use IFASMER to generate the JES2 record type 57 macro mapping. For more 
information, see ““‘Using the IFASMFR Macro to Address SMF Record Fields”’ in 
Chapter 4. 


The format is: 


[erie [Nene [tenn] Foret | Sowee [Dwion 
[2 | SMFS7SEG | 2 [binary | internal | Segment descriptor —SSSOSC~S—S~—S 


eae. 
SMF57FLG binary SVC 83 System indicator: 
Bit Meaning When Set 
0-4 Reserved 
MVS/XA 
| VS2 
Reserved 
Lo 


[S| swremty | 1 [binary | internal | Recordtypee SSCSC~—SCSCSCS 
Pe [aem [pe [ee | aa 
aw | was moved to SMF buffer 
a a la 

: in form OOYYDDDF, where F is the sign 
fe [| swre7sio_ | 4 [EBCDIG | SMCASID | _ System identification (taken from SID parameter) 


ew 

chee me 
signifies JES2 ; 

(20 | 74 [swrevsus_| 2 [binary | internal | __RecordsubtypeSSOSC~—SCSCSCSCS 

[22 [16 | swrs7ian [2 [binary | internal | _Length of rest of record, not including this field 

-32_| 20 | smrs7cu> [8 [EBCDIC | JCTJOBIO |Current job identification SSCS 

(40_| 28 | SMFS7ONN | 8 [EBCDIC | NITNODE | Original node name 

| 48 | 30 | SMF57ENN | 8  |EBCDIC | NITNODE Execution node name 

(56 | 38 | SMF57NNN | 8 |EBCDIC Next node name 

| 64 | 40 | SMF57DVN | 8 | EBCDIC SYSOUT transmitter device name 





| 72 | 48 | SMF57TSS | 4 {binary SVC 11 SYSOUT transmitter start time 
176 | 40 | SMF57DSS | 4  |packed | svc1i SYSOUT transmitter start date 


| 80 | 50 | SMF57TPs | 4 | binary SYSOUT transmitter stop time 
| 84 | 54 | SMF57DPS | 4 | packed SYSOUT transmitter stop date 
|s8 | 58 | smFs7Ts! | 8 | EBCDIC Network account number 
|{96 | 60 | smes7ts: | 4  |[epcpic | $siD | _ SYSOUT transmitter system identification 
| 100] 64 | SMF57CNT | 4 | binary Count of logical TP records 





Chapter 6. SMF Records 6-139 











Record Type 57 (39) — JES3 Networking SYSOUT Transmission Record a 
7 


Record type 57 is written by IATNTSD whenever JES3 completes a network 
transmission. This record contains original and current job identifiers, 
accounting information, transmission path, and destination. The length is 170 bytes. 


The format is: 


fortes [Name [Longin] Format [Source ss Deeription 
|o | o | SMFNJLEN —2—eest__pesr Record 2 Rewieat  __ 
Ears SMFNJDES | 2 [binary | | internal | | Segmentdescriptor i ists—i‘—sS descriptor 


SMFENJFLG binary SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
6 VS2 
7 Reserved 


| 5 | 5 | SMFJNRTY| 1 [binary | internal —s|_—Recordtype 
OR i a rc 
record was moved to SMF buffer 
buffer, in the form OOY YDDDF 
| where F is the oo 
aa [FRESE | TERI St 
parameter) 
: Le ae ff Subsystem identifier X‘0005’ signifies 
ae a, 


| 2: {binary | Reserved |. | ie. a? 


Re a eae ae Se SC aaa 
[2418 | SMENIETM| 4 [binary | STRTIME | Transmission sterttime SSCS 
[2e_[ 1 | SMENJEDT| 4 [EBCDIG | STRTIME | Transmission startdate SSCS 


32 20 SMFNJIND EBCDIC Job type indicator 
JB — indicates data is a job stream 
OP — indicates data isaSYSOUT data stream 


raa_[ 3a | SwENINAM] 8 [EBCDIC | NUEJOBNM | JobnameSSOS—SCSCSCSCSCS 
[a2_[ 2a | SMFNINUM| 4 [EBCDIC | NIMSGINO | Current JESG-amigned ob number 
raé_| 26 | SMENJONM| 2 [EBCDIC | NJEJOBNO | Original number 
a se A. ARI 
[s0| 32 | SMFNUPGM| 20 [EBCDIG | NJEPRGMA | Progremmerneme 











70 [ 46 | SMFNIUSR | @ [EBCDIG | _NJEUSRID | Origin or notify ueeridentifier ————SOSCSC~SCS 
[7e_[ ae | smeNsact| 8 [escbIC_| NJEACCT | Networking account number 
[es_[-s6 | smensopt| 8 [escpic | NsEDEPT | Department number SSS 
[ea _| se | smrnsep|@ [egcoic | NJEBLOG | Building number SSS 
[oz [66 [swrnstoc| 8 [escpic | NiEROOM | Location number 
rio 6& | sMFNIORG| 8 [EBCDIG | internal | JoborginSSCSC~—S 
Cie [ 76 |_SMFNaRMT| 8 [EBCDIC | internal | Secondary ob origin SSCS 
i676] SMFNIxeQ] 8 _[EBCDIC | NJEXEGN | Execution node name 


fee nn 
[aa |e | swensosr [8 [score | sosoest | Deiat nose ar 

6 SMFNJPTH EBCDIC NJEPATH Transmission path node name 
fal senor sae | eet ee 
[rez [a2] CMRNICNT] 4 [binary | XCHARCNT | Compressed byte count SSCS 
ries [a6] SMENITAN| 4 [binary | XBUFCNT | Transmission buffer count SSS 
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( “hs Record Type 58 (3A) — JES2 Network SIGNOFF Record 


Record type 58 is written by HASPNET at each node when a networking session 
is terminated. The record contains the node name, member number, and line name. 
Its length is 42 bytes. 


Use IFASMFR to generate the JES2 record type 58 macro mapping. For more 
information, see “Using the IFASMFR Macro to Address SMF Record Fields’’ in 
Chapter 4. 


The format is: 


| Offsets | Name | Length{ Format | Source | (Description 
[inary | internat | Segment descriptor SSCS 
SVC 83 


|2 | 2 | sMrsesec | 2 
TLE = 
eed 


Bit Meaning When Set 


0-4 Reserved 
SMFS8TME ~ binary SVC 83 Time, in hundredths of a second, record was moved 
to SMF buffer 
A SMF58DTE packed SVC 83 Date record was moved to SMF buffer, in form 
OOYYDDDF, where F is the sign 





















5 MVS/XA 
| 6 VS2 
7 Reserved 


Ee SFSESIO [4 | EBCDIC | SHCASID | System identification 
ia 12 | swFsases | 2 | binary | internal | __ Subaystem identification XOOO7 signifies JES2 | 
[2014 [swrsesua [2 | binary | inernei | Recordsubpe 
[2216 [-swroatrn | 2 _| Binary | internal | Length of rest of record, nat including this Feld 
[aa [18 | SMFBaNNM [8 | EBCDIG| NITNODE | Nodename SSCSC~S~CSCSCS 
[32_[ 20 | SmréameM [1 | Binary | DCTNO | __Membernumber—OOSOCSC~SCS 
asa [swrseavi [1 [binary [ «YR SSCS~—SCS 
[a4 _[- 22 SWFSBLNM | 8 | EBCDIG | DETDEVN | Linename———— 
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Record Type 59 (3B) — MVS/BDT File-to-File Transmission Record 


Record type 59 is written by BDTACMN when MVS/Bulk Data Transfer 
(MVS/BDT) completes a file-to-file transmission. MVS/BDT writes the record from 
the global node where the transaction is queued. MVS/BDT produces a record type 
59 whether or not the transmission successfully completes. 


The record contains sections for MVS/BDT product information, transaction 
identification, file-to-file (FTF) and network information (transaction type 
section), transaction data, transaction accounting information (which is 

optional), and transmission information. There are two 40-byte fields for user _ 
information at SMF59US1 (transaction data section) and SMF59US2 (transmission 
data section). . 


The SMF record mapping macro for record type 59 is IFASMFR. IFASMFR uses 
BDTDSMF, and MVS/BDT macro instructions, to generate the mapping. If you 
want record type 59 mapping, make sure that both IFASMFR and BDTDSMF 
reside on the same macro library. BDTDSMF is written in assembler language and 
is supplied on SYS1.AMODGEN. 


The length of record type 59 is 548 bytes plus the length of the transaction 
accounting section if included. (The transaction accounting section is optional.) 


MVS/BDT invokes the optional user exit BDTUX24 prior to writing the record. 


The format is: 


[eres [nom [ema [Foe 


SMF59LEN | 2 | binary internal Record length 
SMF59SEG internal Segment descriptor 


4 SMF59FLG binary SVC 83 System indicator 
j Meaning when set 
Subsystem name follows system identification 
Reserved 
MVS/XA 
OS/VS2 
Reserved 
5 ze 





SMF59TME 4 binary SVC 83 Time, in hundredths of a second, record was written by SMF 
| en > lee SVC 83 Data record was written by SMF buffer, in the form O0yydddF 
where F is the sign. 
fe _[awrsosio [+ | score | vows 


’ 
CIRNT nrnadirt cartian 


=a f= (o>) & TN 
ors 





2 
2 
1 
1 
4 
4 
2 
4 















28 SME59LPD ; 





Length of MVS/BDT product section 
internal Number of MVS/BDT product sections 





SMF59NPD 





: (Continued) 
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“ 














| Offsets | Name | Length | Format | Source Description 

[32 |20 | smrsgot: | 4 | binary | internal | Offset to transaction identifier section 

f38 }26 | smrsonti | 2 | binary | internal | Number of transaction identifier sections 
40 | 28 | SMF590TT | 4 | binary | internal Offset to transaction type section 
[a8 [2e | swesonrt [2 | binen 
fae_[s0_[ swrssoro [4 | binary | ineret [Ofer wansscton date ction 
[se_[ae_[seweoors [4 | binary 
[co pinay 











ac 


binary Number of transaction accounting sections (an optional section) 


EBCDIC MVS/BDT version number (‘01’) 


EBCDIC Product name ‘MVS-BDT’ | 
EBCDiIC | TVTSYSID | MVS/BDT node name 


EBCDIC Transaction type identifier — “FF” for FTF, ‘NJ’ for NJE 


EBCDIC | JCTJOB MVS/BDT job number 


Reserved 


Sean 
a 


#36 SMF59TSP 
EBCDIC | MJDXBSI MVS/BDT transaction source node | | 


+52 | +34 | SMFSOTUT 2 EBCDIC | MJDXTYP Transaction source userid type: 


‘J3’ — JES3 (for NJE) 


70 [26 | SursonTa 


MVS/BDT Product Section: 





SMF59RCD 


SMF59BDT 


+18 | +12 | SMF59TID | 


2 








SMF59T11 


+12 fC | SMF59TI2 


+20 | +14 SMF59TQS 








‘T’' —TSO user 

‘J‘ — JES console 
‘B‘ — Batch job 
‘M‘ — MCS console 












G 
“i 
NO 

8 
” 
Ss 
nN 
oO 
co 
+ 
” 
” 





Reserved 

















+56 | +38 SMF59TSU EBCDIC Transaction source userid 
internal Blank for NJE 
_ MJDUSID TSO userid 
MJDCNDD JES console DD name 
| MJDBJAM Batch job name 
MJDMCSI MCS console identified 








Transaction Type Section for FTF: 
SMF59ONN 8 EBCDIC | MJDFRLOC 


+0 | +0 
+52 SMF59OMN FB | EBCDIC PDS member name of origin file if specified in SEQ transaction 
SMF590V1_ | 


+3C EBCDIC | MJD text unit || First volume serial number for origin file if specified in | 
transaction 
SMF590FG EBCDIC Origin file flag: ‘D’ - DUMMY specified | 








MVS/BDT origin node name 











Origin file name if specified in transaction 










(Continued) 
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} 


Offsets | Name | Length | Format_ 
SMF59DNN 
SMF59DFN 


+122 SMF59DMN 


EBCDIC| MJDTOLOC | MVS/BDT destination node name 
EBCDIC; MJD text unit Destination file name if specified in transaction | 


8 | EBCDIC!] MJD text unit PDS member name of destination file is specified in SEQ 

a : | | transaction 

+82) SMF59DVI | ENCDIC] MJD text unit First volume serial number for destination file is specified 
in transaction | 

SMF59DFG EBCDIC] internal Destination file flag: ‘D’ —- DUMMY specified 

+137] +89] SMF59TT2 Lime 


+ 1+ 
“SPN 
alg 











fi 
eed 
® 
© 





8 
= 
G 
oO} 


Reserved 


‘I’ — INTRDR specified 





























EBCDIC | MJD59NJT Job type: 
JB — data is a job stream 


OP — data is a complete SYSOUT 
Original job number (NJHGJID) 








binary MJD59NUM 


hi 
a 







E 
a 


SMF59NR1 
SMF59NAN 


binary Reserved 
MJD59NAN . Network account number (NJHGACCT 
MJD59NAM “Original job name (NJHGJNAM) 
MJDJESNR | JES3 job ID _ a 


-EBCDIC | MJDS59NUI | Notify user id (NJHGUSID) 


MJD59NDT 








SMF 59NUM 






Ee 
| aes 
aes 

| SMF59JID | Be 
“30, | SMF59NUI | ‘SMF59NUI fg | 3 
8 

sel 

| 8] 

| 207 

eo 

| 8 | 


ls 
NO 
N 


Job entry date/time stamp on origin node (NJHGETS) 


SMF59NDT 
SMF59XON 


NO 
m 


EBCDIC | MJD59XON | Execution node name (NJHGEXQN) | ae 7 


Execution user id (NJHGUSID) 


ie) 
a 


SMF59XOQU 


EBCDIC | MJD59XQU 


e 
2 
20 EBCDIC | MJD59NPN Programmer's name (NJHGPRGN) 





oO 
m 


SMF59NPN 


COT Oi ai Ri ®] & 
NL Mi BR] Os} Of oO 


SMF59NPR 


W 
NO 


EBCDIC | MJD59NPR_ | Programmer’s room number (NJHGDEPT) 


| EBCDIC | MJD59NPD Programmer’s department number (NJHGDEPT) 


EBCDIC | mJD5S9NPB | Programmer's building number (NJHEBLDG) | 






ol 
s 


SMF59NP# 


a 
RO 


SMFS9ONPB 


SME59NAM 


Oo 
“a 


Transaction Data Section: | | 
SMF59TTO | binary MJDJST 
Date transaction was queued, in the form OOY YDDDF, where F 


4 SMF59DTQ packed MJDJSD 
is the sign (GMT) 
SMF59TTC | binary internal Time, in hundredths of a second, transaction was completed 
(GMT) 


aoe erent 
=|90 
BID 


wl 






3b 


Time, in hundredths of a second, transaction was queued 
(GMT) 







EEE 


+ + + 









+12 C Date transaction was completed, in the form OOYYDDDEF, 
where F is the sign (GMT) 
+16 1+10 | SMF59BJN | ee EBCDIC | MJDJOBNM | MVS/BDT job name 


SMF59TPR EBCDIC | MJDXPRTY | Transaction priority | 
'04' — operator cancelled 


2E SMF59TCM EBCDIC | internal 
| | ‘08’ — abnormal 


SMF59BTC EBCDIC | MJDXCODE |MVS/BDT transaction code X‘51‘ — NJE transaction 
, © — seif-defining transaction GMiJD member name 


+] + 
nN} = 
(@) 


ee) 






Transaction completion code: ‘OO’ — normal 






ee 
wo 
oS 


+38 | SMFS59TD1 Reserved 


= 
+3¢ | SMF59BCT | 8 | binary MJDBYTES | Number of bytes transferred 
4 | SMF59US1 | 40 | EBCDIC User area (initialized with blanks) | 


BOoMIcE 


c 
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+0 


Transact 


SMF59X01 

SMF59X02 
SMF59SNN 
SMF59X03 
SMF59 X04 
SMF59X05 
SMF59RCN 
SMF59X06 
SMF59XST 


SMF59XSD 


SMF59XPT 


SMF59XPD 


SMF59X08 


SMF59X09 
SMF59XOC 


| SMF59XDC 


SMF59X10 
SMF59US2 


counting Section: 


- © OO Oo Oo © HO OW 


40 
(This s 





EBCDIC 


EBCDIC 


binary 


packed 


binary 


packed 


EBCDIC 


EBCDIC 


EBCDIC 


[ms [Fore [some 
Transmission Section: ss | | CE 


MJDFRLOC 


MJDTOLOC 


MJDXST 


MJDXSD 


MJDXPT 


MJDXPD 


SEFRCOMP 
(JCT) 


SETOCOMP 
(JCT) 





ection is optional.) 


Description 


Reserved 

Reserved 

MVS/BDT sender node 
Reserved 

Reserved 

Reserved 

MVS/BDT receiver node 
Reserved 


Time, in hundredths of a second, transmission started 
(GMT) 


Date transmission started, in the form OOY YDDDF, where 
F is the sign (GMT) 


Time, in hundredths of a second, transmission stopped 
(GMT) 


Date transmission stopped, in the for OOYYDDDF, where F 
is the sign (GMT) 


Reserved 


Reserved 
Transmission origin completion code 


Transmission destination completion code 


Reserved 


User area (initialized with blanks) 


+0 | 40 SMF59ACT variable) EBCDIC | MJD text unit User accounting data from ACCT parameter 
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Record Type 60 (3C) — VSAM Volume Data Set Updated 


Record type 60 is written by IGGOCLED when a VSAM Volume Record (VRR) 
is inserted, updated, or deleted from a VSAM Volume Data Set (VVDS); for 
example, when a VSAM cluster is defined, closed, or deleted, one type 60 record 
is written for each VRR written or deleted. 


Record type 60 identifies the VVDS in which the VVR is written or deleted 
and gives the new, updated, or deleted VVR. It identifies the job by job log and 
user identifiers. 


The length of the record is 208 bytes plus the length of the VVR. 


The SMF record mapping macro for record types 36, 60, 61, 65, and 66 is 
IFASMF 16. 


Its format is: 


IFASMFI6 nn 


where nn identifies the type of the record you want to map. The mapping macro 
_ resides in SYS1.MACLIB. 


The format is: 


Offsets ee 
SMFGOLEN ianath of record descriptor word 
SMF60SEG Record descriptor word descriptor 


SMF60SYS System indicator 


SM FEORTY 


ele 










Bit Meaning When Set 
0-4 Reserved 








5 MVS/XA 
: VS2 
VSi 


> | 


SMF60DTE packed SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
— oy xs EBCDIC SMCASID System identification (taken from SID Surarriater) 


_—Sarenses_ = EBCDIC VVDS parameter Contains ’ IN! if VVR is inserted: ‘UP’ if VVR is eeetree 
— or ‘DE’ if VVR is deleted 





SMF6OPOF | 4 | binary binary internal =| Offset of product section 


oat SMF6O0PLN ea binary Length of product section 


| 30 | 16 | SMF60PNO Le binary internal Number of product sections 
36 | ‘ 





24 _SM F60D LN binary internal Length of data section 
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Record type 


SMF60TME He l sve 83 Time, in hundredths of asecond. record was mowed to > SMF 
buffer 


a 
y 





















Product and data section: 





SMF60VER EBCDIC 


Version of the type 60 record 


40 28 | 
| 42 | 2A | SMF60PNM 18 EBCDIC internal Catalog management product identifier 


Job name 1 
JMRENTRY 


| 50 | 32 | smFeosnm | 8 | EBCDIC] JMRJOB 
Time, in hundredths of a second, reader recognized the 


3A SMF6O0RST binary 
| JOB card for this job 
3E SMF6ORDT packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign | 
fad Goan SMF60UID 8 EBCDIC]| JMRUSEID User identification (taken from common exit parameter 
area) 


foe tae SMF60CNM ho EBCDIC| VVDS parameter Name of VVDS in which entry is made 
list 


rive] 77 | swreorve [1] escpie| wacowre | ery yoolsenife 
Tao] 7a | swreoenw| «a | eacoic| vwacwenm | entyneme 
aa |sweconnw[ ae [|| ered 


SMF6O0CRC | var- binary | VVR VVR (the length of the VVR is contained in the first 2 
iable bytes of this field) 


‘The job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 
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Record Type 61 (3D) — Integrated Catalog Facility Define Activity 


Record type 61 is written by IGGOCLED when an ICF catalog record is written 
during the processing of an Access Method Services DEFINE command. One type 
61 record is written for each record inserted or updated in a catalog. Record type 
61 identifies the entry being defined and the catalog in which the catalog record is 
written, and gives the new or updated catalog record. It identifies the job by job 
log and user identifiers. 





Its length is 208 bytes plus the length of the catalog record. 
For a description of the mapping macro, see Record type 60. 


The Onna is: 


a SMF61LEN Length of record descriptor word 
caee SMF61SEG Record descriptor word descriptor 
VS2 


SMF61SYS binary |SVC 83 
VS1 


ope SMF61TME if SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 




























System indicator 


Bit Meaning When Set 
0-4 Reserved 
MVS/XA 


~! 6) O1 





















- 
Ee ee 7 
O0OOYYDDDF where F is the sign 
| SMF61CPU__ | SMF61CPU__ | EBCDIC eee System identification | System identification (taken from SID parameter) from SID | System identification (taken from SID parameter) 
ee el 
a oe Contains ‘IN’ if VVR is inserted; ‘UP’ if VVR is updated: 
list or ‘DE’ if VVR is deleted | 
[aa | te | swreiror | 4 | binary intemal | Offer ofproducteestion 
Tae [1e-[awranein [2 [ener [imma [ tang of poet set 
[a0 [4e | sureieno [2 [ einery [intemal | Numberot product wets 
[a2 [20 | seei00r | 4 | binary [invernol | Offstof dotesection 
fae | 24 | swreroun | 2 | binary |invernat | _Laneth of detesection 
[se [26 | swretono | 2 | binary [internat | _Numberofdetesestiong 
(Continued) 
f ~ 
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C 








es 


Product and data section: 
SMF61VER EBCDIC Version of the type 61 record 


EaES SMF61PNM | 8 | EBCDIC| internal  _—s«t_—Catalog management product identifier 


3A SMF61RST binary JMRENTRY Time, in hundredths a a second, reader recognized the 
JOB card for this job" 
3E SMF61RDT packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form 0OOY YDDDF where F is the sign ’ 
iat il SMF61UID Reel al EBCDIC; JMRUSEID User identification (taken from common exit parameter 
5" Se 


SM | SMF61FNC | FNC | Reserved 


==. SMF61CNM to EBCDIC a Name of catalog in which entry is defined 
/119| 77 | SMFe1TYP a EBCDIC| internal —s|_Entry type identifier 


aa Serna 


| SMF61NNM | | Reserved ssi 
SMF61CRC | var- tt se record New catalog record for defined entry (the length of this 
iable record is contained in the first two bytes of this field) 


'The job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. If 


a system task caused the record to be written, the job-name and user-identification fields contain blanks and the time and date 
fields contain zeros. 
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Record Type 62 (3E) — VSAM Component or Cluster Opened 


Record type 62 is written by IDA0192S at the successful or unsuccessful 
opening of a VSAM component or cluster. Its length is 142 bytes plus ten 
bytes for each volume listed. 


Record type 62 identifies the VSAM component or cluster and indicates whether 
it was successfully opened. It names the VSAM catalog in which the object is 
defined and the volumes on which the catalog and object are stored. It also 
identifies the job that issued the OPEN macro by job log identification and user 
identification. 


Note: This record is not generated when a system task issues the OPEN macro. 
The format is: 


internal Record length 


internal Segment descriptor 


SVC 83 System indicator 
Bit Meaning When Set 


0-4 Reserved 
5 MVS/KA 
6 VS2 

7 VS1 | 


internal Record type 


SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 


SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 

SMCASID System identification (taken from SID parameter) 

JMRJOB 


JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job! 

JMREDATE Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign! 


SMF62UIF EBCDIC] JMRUSEID User identification (taken from common exit parameter area) 


SMF62IND 4 binary Set by IDAO192A 
and passed to 
1DA0192S in 
parameter list 


Offsets 


SMF62LEN 
SMF62SEG 
SMF62FLG 


2 
2 
1 


binary 
binary 












binary 





SMF62RTY 
SMF62TME 


binary 
4 binary 


SMF62DTE packed 


SMF62SID 
SMF62JBN 
SMF62RST 


4 EBCDIC 
EBCDIC 


binary 


NO 


4 


E SMF62RSD packed 


r 
© 
=| 
© 
ot 
i 


2A Open status indicator 


Meaning When Set 

Component or cluster was successfully opened 
Security violation, that is, invalid password 
Record is a catalog or CRA record 

Record is for a VVDS or ICF catalog being opened 
or closed as a data set2 

Reserved 


EBCDIC] CAXCNAM Name of the catalog in which the component or cluster is 
(in |IGGCAXWA) defined 


EBCDIC] UCBVOLI Volume serial number of the volume containing the catalog 


EBCDIC] JECBDDNM Name of the component or cluster being opened 


OPEN routine 
calculates from 
VMT entries 





oO 


rH) a) NT-T— 
a i TE LR a 
foe) ol N N = =f = > N 
N > 


mi 


SMF62CNM 44 


> 


SMF62CVS 
SMF6E2DNM 
SMF62VCT 


44 
2 


Number of online volumes containing the component or 










—2 
aS 
oO 
O 


binary 


cluster. (This field is also the number of ten-byte fields 
that Jist the volumes.) 





For each online volume, there is a ten-byte entry with the following format: 
+0 


eMrezven | 6 j sBeole 


VMTVLSER | Volume serial number of the volume containing the 
_ component or cluster 





SMF62DTY 4 binary UCBT YP Unit type of the volume containing the component or 


cluster 






1The job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 
21f this bit is set, the catalog name field and the cluster name field might be set to zeroes. 
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( : Record Type 63 (3F) — VSAM Entry Defined 


Record type 63 is written by IGGOCLBV when a VSAM catalog entry (a component, 
cluster, catalog, alternate index, path, or non-VSAM data set) is defined by the Define 
Access Method Service command and when that definition is altered. For example, 
when a VSAM catalog entry (1) is altered with new space allocation information (that 
is, when the VSAM End-Of-Volume EOV routine extends the entries object), or (2) 

is changed by the Alter Access Method Services command. One record type 63 is 
written for each newly created or altered entry. Its length is 136 bytes plus the length 
of the catalog records required to describe the entry. 


Record type 63 identifies the catalog in which the object is defined, gives the 
catalog record for the newly defined object, and, for an alteration, gives the parts 
of the old catalog record before they were altered. It identifies the job by job log 
identification and user identification. 


Notes: 

. The length of this record can be from 1000 to 4000 bytes or more, depending 
upon the sizes of the new and old catalog records (offsets 44 and 46, respectively). 
If this record is to be written to the SMF data set, be sure to include the sizes of 
these catalog records when estimating the additional storage required for the SMF 
buffer and the SMF data sets. 

2. This record is not written when a VSAM catalog entry is renamed. (Record type 

68 is written in this case.) 


( - The format is: 


—_— 







Source Description 


SMF63LEN 
SMF63SEG 
S 


MF63FLG binary [SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
MVS/XA 
: VS2 
VS1 


| SMFE3RTY internal | Record type 


SMF63TME Se iad SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 


internal Record length 


binary | internal Segment descriptor 





> 


SMF63DTE SVC 83 Date record was moved to SMF buffer, in the form 


| OOY YDDDF where F is the sign 


EBCDIC | SMCASID System identification (taken from SID parameter) 
SMF63JBN 


EBCDIC | JMRJOB Job namet 
A | SMF63RST JMRENTRY Time, in hundredths of a second, reader recognized the 


awn, 


JOB card for this job? 


packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign 


EBCDIC | JMRUSEID User foe neinication (taken from common exit parameter 
area) 


SMF63UIF 


1The job name and the time and date that the reader recognized the JOB card for this job constitute 
the job log identification. If a system task caused the record to be written, the job-name and user- 
identification fields contain blanks and the time and date fields contain zeros. 


6 
2) 
=] 
5 
=) 
& 
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a a 


2A | SMF63FDT VSAM catalog 
record entry type 
| - ie 


thee iad ie 
| binary 
include the contents of this field when estimating the 
additional storage required by SMF.)2 


SMF63CNM | CAXCNAM Name of catalog in which the entry is defined | 
(in IGGCAXWA) 
5C 44 Name field of VSAM Entry name 
catalog record 


iW lacie VSAM catalog entry 


records 
2A VSAM catalog record is contained in one or more physical 
‘catalog records. Offsets 44 and 46 are the sums of the sizes 
of the physical catalog records that constitute the total logical 
VSAM catalog record. 
















Record ssaseanieate type indicator 
Bit Meaning When Set 


binary 





0 New definition 
1 Altered definition 
2-5 Reserved 


6 Path defined or altered 
7 Alternate index defined or altered 














VSAM catalog 
record entry type 


Entry type indicator 
Bit Meaning When Set 
0 VSAM cluster 

1 VSAM data component 
2 VSAM index component 
3 VSAM catalog 

4 Non-VSAM data set 
5 

6 

7 










Generation data group 
Alias 
Reserved 


Size of new catalog record. (Be sure to include the contents 
of this field when gatimating the additional storage 
required by SMF.) 


Size of old catalog record. This field contains the size of 
the old records before they were altered. (Be sure to 














New catalog record followed by old catalog record. 
For the new catalog record, the complete new entry is 

recorded. For the old catalog record, this field contains 
only those old records that were altered; it shows what 
these records were before they were aitered. 
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Record Type 64 (40) — VSAM Component or Cluster Status 


( | Record type 64 is written when (1) a VSAM component or cluster is closed, (2) 
VSAM must switch to another volume to continue to read or write, and (3) there 
is no more space available for VSAM to continue processing. If a cluster is closed, 
one record is written for each component in the cluster. This record is written by 
IDA0192S. Its length is 254 bytes plus 26 bytes for each extent. 


Record type 64 indicates why the record was created (a component was closed, 
another volume was switched to, or no additional space was available). It describes 
the device and volume(s) on which the object is stored, and gives the extents of the 
object on the volume(s). It also gives statistics about various processing events that 
have occurred since the object was defined, such as the number of records in the 
data component, the number of records that were inserted, and the number of 
control intervals that were split. This record identifies the job by job log 
identification and user identification. 
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| 













internal Record length 
| 2 [binary | Segment descriptor 


aa SVC 83 System indicator | 


Bit Meaning When Set 







SMF64LEN 
SMF64SEG 


SMF64FLG 


The format is: 















0-4 Reserved 
5 MVS/XA 
6 VS2 

7 VS1 


Record type 


SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 





SMF64RTY 


SMF64TME si 
A |SMF64DTE Le 


—_ 
O & | NOLO 


packed jSVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


| 4 | EBCDIC |SMCASID System identification (taken from SID parameter) | 


JMRENTRY r 


Time, in hundredths of a second, reader recognized the JOB 


Sos 


A |SMF64RST 


SMF64RSD 








card for this job! 










packed |JMREDATE Date reader recognized the JOB card for this job, in the 


form OOYYDDDF where F is the sign? 


SMF64UIF 


La EBCDIC | JIMRUSEID User identification (taken from common exit parameter 
area) | 


SMF64RIN 


~S AOORWN-O DW 
~ 





SMF64DTY 




















44 EBCDIC |CAXCNAM Name of the catalog in which the component is defined 
(in |IGGCAXWA) 
information. For a catalog record, this field contains 
AM RLIM FB A 


2 binary Situation indicator 
j Meaning When Set 
| Component closed 
Volume switched 
No space available 
Record is a catalog or CRA record 
Component closed, T YPE=T 
Record written during ABEND processing 
Record is fora VVDS or ICF catalog being opened 
or closed as a data set2 
Reserved 
ey 
SMF64DNM EBCDIC | VSAM catalog Name of the component or cluster being processed. For 
1 (ENTNAME) 
the catalog or cluster name. 
ARDHABA Highest used relative byte address (RBA) of the component 


1E 
binary AMBTYPE | indicator of component being processed 
| Bit Meaning When Set 
: 0) Data component 
| 1 Index component 
2-7. Reserved 
SMF64CNM 
a CRA record, this field does not contain meaningful 
SMF64NTR binary {VSAM catalog Number of tracks that were requested but could not be 
| (PRIMSPAC for allocated 
primary allocation; 
SCONSPAC for 
secondary allocation) 
SMF64CHR 4 binary 
(in ARDB) 


iThe job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 
21 this bit is set, the catalog name field and the cluster name field might be set to zeroes. 
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[eras [none [oe] rome | Soe 







For each extent, there is a 26-byte entry with the following format: 
7 SMF64FCC DEBSTRCC 





binary 






SMF64TCC 











binary DEBENDCC 


SMF64VSN EBCDIC | UCBVOLI 
SMF64CUU UCBCHAN 


SMF64IND binary internal 


+18 SMF64UTY binary UCBTYP 
| +22 SMF64RV1 binary 


Statistics Section: 3 
Accumulative Statistics from Creation Until the Current OPEN: 





binary 


+0 SMF64SLN 4 binary internal 

+4 SMF64NIL 4 binary |AMDNIL 
+8 SMF64NEX 4 binary |AMDNEXT 
+12 SMF64NLR 4 binary {|AMDNLR 
+16 SMF64NDE 4 binary |AMDDELR 
+20 SMF64NIN 4 binary |AMDIREC 
+24 SMF64NUP 4 binary j|AMDUPR 
+28 SMF64NRE 4 binary |AMDRETR 
+32 SMF64NFS 4 binary | AMDASPA 
+36 SMF64NCS 4 binary |AMDNCIS 
+40 SMF64NAS 4 binary }AMDNCAS 
+44 SMF64NEP 4 binary {|AMDEXCP 


Change in Statistics from OPEN to Time of EOV and CLOSE: 


+48 SMF64DIL 4 binary |AMDNIL 
+62 SMF64DEX 4 binary |AMDNEXT 
+56 SMF64DLR 4 binary |AMDNLR 
+60 SMF64DDE 4 binary |AMDDELR 
+64 | SMF64DIN 4 binary |AMDIREC 
+68 SMF64DUP 4 binary {|AMDUPR 
+72 SMF64DRE 4 binary |AMDRETR 
+76 SMF64DFS 4 binary AMDASPA 
+80 SMF64DCS 4 binary |AMDNCIS 
+84 SMF64DAS 4 binary |AMDNCAS 
+88 SMF64DEP 4 binary |AMDEXCP 


“These fields are zero for DD*, DD DATA, DD DUMMY and spooled data sets. 
3AII the fields in this section are present and are taken from the AMDSB 


data area; inapplicable fields contain zeros. 








Description 


Beginning cylinder and track, in the form CCHH where CC 
is the cylinder number and HH is the track number 


Ending cylinder and track, in the form CCHH where CC is 
the cylinder number and HH is the track number 


Volume serial number of the volume containing the extent 


Device number 


- Spindle identification 


Unit type 
Reserved 


Length of the statistics section, including this field 
Number of levels in the index 

Number of extents 

Number of records in the component 

Number of records that were deleted from the component 
Number of records that were inserted into the component 
Number of records that were updated in the component 


Number of records that were retrieved from the component 
Number of unused control intervals in the component 
multiplied by the control interval size 

Number of control intervals that were split in the 
component 


Number of control areas that were split in the component 


Number of EXCPs. (For more information about EXCP 
count, see Chapter 8.) 


Change in number of levels in the index 
Change in number of extents 


Change in number of records in the component. The 
field may be negative. 


Change in number of records that were deleted from the 
component 


Change in number of records that were inserted into the 
component 


Change in number of records that were updated in the 
component 


Change in number of records that were retrieved from the 
component 

Change in number of unused control intervals in the 
component multiplied by the control interval size. 

(This field may be negative.) 

Change in number of control intervals that were split 

in the component 


Change in number of control areas that were split in the 
component 

Change in number of EXCP. 
EXCP count, see Chapter 8.) 


(For more information about: 


(Continued) 
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Data Set Characteristics Section: 


SMF64DBS binary 
SMF64DC! binary 
SMF64DLS binary 
SMF64DKL binary 


SMF64DDN 
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[ore [now [rn Foe 


EBCDIC | TIOEDDONM 












LPMBLKSZ Physical block size 

{in IDALPMB) 

AMDCINV Control interval size 

(in AMDSB) 

AMDLRECL Maximum logical record size 
(in AMDSB) 

AMDKEYLN Key length 

(in AMDSB) 





DD name. When the record is written for a VSAM catalog 
or catalog recovery area, this field may contain zeros. When 
the record is written for a volume switch or no space 
available condition, and the volume is associated with a 
concatenated TIOT entry, this field contains blanks. 








ft - XS 
wa 

















Record Type 65 (41) — Integrated Catalog Facility Delete Activity 


Record type 65 is written by IGGOCLED when an ICF catalog record is written or 
deleted during the processing of an Access Method Services DELETE command. 
One type 65 record is written for each record updated or deleted from a catalog. 
Record type 65 identifies the entry being deleted and the catalog in which the 
catalog record is updated or deleted, and gives the updated or deleted catalog 
record. It also indicates whether a VSAM cluster or non-VSAM data set was 
scratched (function indicator = ‘S’), or only catalog information was deleted 
(function indicator = ‘U’). It identifies the job by job log identification and user 
identification. Its length is 208 bytes plus the length of the catalog record. 


For a description of the mapping macro, see record type 60. 


The format is: 


Offsets Name Length 





Source Description 


SMF65LEN binary internal Length of record descriptor word 
internal 


SMF65SEG Et binary Record descriptor word descriptor 


SMF65SYS binary SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
6 VS2 
17 — +VSs1 


oe woe 3 SMF65RTY fa binary | internal Record type 


SMF6S5TME binary SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
ian a SMF65DTE | packed |SVC83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
| & | SMFescPU | 4 | EBCDIC|SMCASID | System identification (taken from SID parameter) 
ria [12 | swresses | s | | [Rew 
ae, EBCDIC Contains ‘IN’ if VVR is inserted; ‘UP’ if VVR is updated; or 
list ‘DE’ if VVR is deleted 
|30 | 16 | smrespno | 2 | binary |internai _| Number of product sections 
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Covews | feme [taoeh | Former [Sour [SC meinion 


SMF65VER a EBCDIC Version of the type 65 record 


40 28 
| 42 | 20 | SMF65PNM Bowe EBCDIC internal | Catalog management product identifier | 
| 32 | smresunm | 8 | EBCDIC}JMRJOB Job name! 


SMF6E5RDT packed | JMREDATE ‘Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign | 
| 66 | SMF65UID EBCDIC | JMRUSEID User identification 
E Contains ‘S’ if a data set was scratched; ‘U’ if only catalog 


4A SMF65FNC BCDIC | internal 
entries were modified 


Pts 
SMF65CNM EBCDIC | CAXCNAM Name of catalog in which record was updated or deleted 
}119| 77 | smrestye | 1 | EBcDIC Entry type identifier 









Product and data section: 























Time, in hundredths of a second, reader recognized the’ 
JOB card for this job! 








list 


| P| Reserved 


208 a SMF65CRC | var- binary Catalog record Catalog record for updated or deleted entry (the length of 


iable this record is contained in the first two bytes of this field) 
The job name and the time and data that the reader recognized the JOB card for this job constitutes the job log identification. If 
a system task caused the record to be written, the job name and user identification fields contain blanks and the time and date 
fields contain zeroes. | 
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fo™ 
a, 














Record Type 66 (42) — Integrated Catalog Facility Alter Activity 







| oe or SMF66LEN 


Pe fs | swrcaary 


ia ae SMF66TME 
fies ak SMF66DTE 


rae | aareecro 
Tie [ 2 | swresses 


ia ae SME66SUB 


[aa | 78 | Swresror 
a0 | te | SMraseNo 
[32 [20 | swreeoor 
rae | 24 | SMFBSDUN 










[offsets | Name Length 
| 2 | 2 | smreesec | 


| SMF66SYS 


Record type 66 is written by IGGOCLED when an ICF catalog record is written or 
deleted during the processing of an Access Method Services ALTER command or 

a data set extend operation. One type 66 record is written for each record written 

or deleted from a catalog. Record type 66 identifies the entry being altered and the 
catalog in which the catalog record is written or deleted, and gives the new, updated, 

or deleted catalog record. It also indicates if the entry was renamed (function indicator = 
‘R’) and, if so, gives the old and new names of the entry. It identifies the job by job 

log identification and user identification. Its length is 208 bytes plus the length of the 
catalog record. 


For a description of the mapping macro, see record type 60. 


The format is: 


inary Length of record descriptor word | : 
inary Record descriptor word descriptor 


binary SVC 83 










Al 


H 














Bit Meaning When Set 
0-4 Reserved 

5 MVS/XA 

6 VS2 

7 VS1 





1 


4 






System indicator 
packed {SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
EBCDIC | SMCASID System identification (taken from SID parameter) 
Contains ‘IN‘ if VVR is inserted; ‘UP’ if VVR is updated; 
binary Offset of product section 
2 binary Length of product section 
binary Number of product sections 
binary internal Offset of data section 
binary Length of data section 
binary Number of data sections . 


(Continued) 


binary SVC 83 Time, in hundredths of asecond record was moved to SMF 
buffer 
EBCDIC | VVDS parameter 
list or ‘DE’ if VVR is deleted 


4 
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Product and data section: | 
SMF66VER EBCDIC Version of the type 66 record 


toe SMF66PNM | 8 | EBCDIC internal Catalog management product identifier 
| 50 | 32] smF6esNM | 8 | EBCDIC|JMRJOB Job name‘ 








ad SMF66RST binary |JMRENTRY Time, in hundredths of a second, reader recognized the 


JOB card for this job! 


SMF66RDT 4 packed |JMREDATE Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign ' 
ba SMF66UID ia EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area) 


| 74 | 4a| SMF66FNC | 1 | EBCDIC|internal —_—_—| Contains ‘R’ifcatalogentry isrenamed = 
ae SMF66CNM. | 44 EBCDIC “oa _| Name of catalog in which entry is updated or deleted 


SMF66TYP sia a EBCDIC Entry type identifier 


EBCDIC | Catalog parameter | Current ie is ics IEE name 
list 
list 


SMF66CRC var- binary {| Catalog record Catalog record for updated or deleted entry (the length of 
iable this record is contained in the first two bytes of this field) 


‘The job name and the time and date that the reader recognized the JOB card for this job constitutes the job identification. Ifa 
system task caused the record to be written, the job name and user identification fields contain blanks and the time and data fields 
contain zeroes. 
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Record Type 67 (43) — VSAM Entry Deleted 


( Record type 67 is written by IGGOCLBV when a VSAM catalog entry (a component, 
cluster, catalog, alternate index, path, or non-VSAM data set) is deleted. A type 63 
record is written for each entry affected by the DELETE Access Method Services 
command. For example, three records are written for an indexed cluster: one for 
the relationship between the components of the cluster, one for the data component, 
and one for the index component. Its length is 134 bytes plus the length of the 
catalog records required to describe the entry. 


Record type 67 identifies the deleted entry, the VSAM catalog in which the entry 
was defined, and the deleted catalog records. It identifies the job by job log 
identification and user identification. | 


Notes: 

1. The length of this record can be from 1000 to 4000 bytes or more, depending 
upon the sizes of the catalog records that describe the entry (offset 132). If this 
record is to be written to the SMF data set, be sure to include the sizes of these 
catalog records when estimating the additional storage required for the SMF 
buffer and the SMF data sets. | 


The format is: 


[oft [Nome [conn | Forma 
| Of o- SMF67LEN internal Record length 
rT SMF67SEG | 2 | binary | internal Segment descriptor 















6 VS2 
7 VS1 





7 7 aa 7 SS 


Bit Meaning When Set 
| 5 | SMF67RTY 


0-4 Reserved 
ei SMF67TME 





binary jj internal Record type 
binary |SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 





packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 


EBCDIC | SMCASID System identification (taken from SID parameter) 


| & | SMF67SID | 
JMRENTRY Time, in hundredths of a second, reader recognized the 


1A | SMF67RST 
JOB card for this job? 


5 MVS/XA 
A | SMF67DTE ; = 
SMF67RSD packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign? 









ot SMF67UIF EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area)? , 


SMF67FDT | binary 


1The job name and the time and date that the reader recognized the JOB card for this job constitute the job log (Continued) 
identification. If a system task caused the record to be written, the job-name and user-identification fields contain. 
blanks and the time and date fieids contain zeros. 

2Both indicators are set for VSAM component or cluster entries. For all other VSAM entries, only the uncataloged bit is set. 

For non-VSAM entries, the uncatalog bit is always set and the scratched bit is set if the physical non-VSAM space was deleted. 






VSAM catalog 
record entry type 


Record creator/entry type indicator 


Bit Meaning When Set 

0 Uncataloged 

1 Scratched 

2-5 Reserved 

6 Path deleted 

7 Alternate index deleted 
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record entry type Bit Meaning When Set 
| VSAM cluster | 
‘VSAM data component? 
2C | SMF67CNM 44 EBCDIC |CAXCNAM Name of catalog in which the entry was defined | 
(in IGGCAXWA) | — 
SMF67DEN 44 EBCDIC | Name field of VSAM| Entry name : 
catalog record | 
SMF67RSZ binary Size of catalog record that defined the entry.* (Be sure to 
include the contents of this field when estimating the 
additional storage required by SMF.) 










VSAM index component? 
SMF67CRC | variable | binary | VSAM catalog Catalog record* _ 
entry records 


VSAM catalog 
Non-VSAM data set 
3, data or index component can only be deleted as one of the three catalog 
records deleted when a cluster is deleted. 


Generation data group 
44 VSAM catalog record is contained in one or more physical catalog records. 


ots [Nene [Long [Format] Sows [SC mmintonSCSC*d 
Alias 
Offset 132 is the'sum of the sizes of the physical catalog records that constitute 


| 2B | SMF67I0D VSAM catalog Entry type indicator 
ee Reserved 
the total logical VSAM catalog record. 
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( = Record Type 68 (44) — VSAM Entry Renamed 


Record type 68 is written by IGGOCLBV when a VSAM catalog entry (a component, 
cluster, catalog, alternate index, path, or non-VSAM data set) is renamed using the 
ALTER Access Method Services command. This record identifies the VSAM catalog 
in which the object is defined, and gives the old and new names for the object. It 
also identifies the job by job log identification and user identification. Its length is 
174 bytes. 


The format is: 


binary [internat Soament desonpior 
SMF68FLG SVC 83 


System indicator 
Bit Meaning When Set 
0-4 Reserved. 
4 binary {SVC 83 Time, in hundredths of a second, record was moved to | 
SMF buffer 
A SMF68DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F isthe sign |. 


5 MVS/XA 
SMF68SID EBCDIC | SMCASID System identification (taken from S!Diparameter) 24 


i 




















SMF680NM 





‘Old name of the entry. (AMS obtains this name from the 
ALTER command.) 















New name of the entry. (AMS obtains this name from the 
ALTER command.) 


SMF68RSD packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign 
SMF68UIF EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area) | 
EBCDIC [Pointed to by | 
CTGNEWNM field 
1The job name and the time and date that the reader recognized the JOB card for this job constitute 


6 VS2 
SMF68JBN EBCDIC | JMRJOB Job name? : 
SMF68CNM EBCDIC |CAXCNAM | Name of catalog in which the entry is defined 
(in IGGCAXWA) | 
in (EZCTGPL 
the job log identification. If a system task caused the record to be written, the job-name and user- 


7 VS1 
1A. SMF68RST binary |JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job? 
EBCDIC |Pointed toby 
CTGFVENT field in 
{IEZCTGFV 
parameter list 
parameter list 
identification fields contain blanks and the time and date fields contain zeros. 
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in 


[es | swrcoary 





Record Type 69 (45) — VSAM Data Space Defined, Extended, or Deleted 


Record type 69 is written by IGGOCLBV when a VSAM data space is defined, 
extended, or deleted using the DEFINE or DELETE Access Method Services 
commands. Record type 69 is not written when a catalog or a unique data set is 
defined or deleted. Its length is 106 bytes. 


This record identifies the catalog in which the data space is defined and the 
volume on which it is (or was) allocated. It also gives the number of free data 
space extents and the amount of unallocated space on the affected volume after 
the definition, extension, or deletion. It identifies the job by job log identification 
and user identification. 


The format is: 


Catia [Wome [tone] rormat | Sowee [Canon 
Record lenath oa 


ro [0 | swreoen[ 2 ~ 


‘binar System indicator 


| binary 
Bit Meaning When Set 
0-4 Reserved 

















5 MVS/XA 
6 VS2 
7 VS1 


binary jSVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
packed {SVC 83 Date record was moved ta SMF buffer, in the form 
OOYYDDDF where F is the sign 
EBCDIC |SMCASID System identification (taken from SID parameter) 
SMFSQJBN EBCDIC |JMRJOB 


A SMF69RST binary |JMRENTRY Time, in hundredths of a second, reader recognized the 
: JOB card for this job+ 


bl Sl sa Ml 
SMF69RSD packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign? 


ie ae SMF69DTE 


N 


SMF69UIF EBCDIC JMRUSEID User identification (taken from common exit parameter 


area) 1 
SMF69CUU 


UCBCHAN Device number | 
_|  SMF69IND | EXCP of sense data | Spindle identification 
SMF69NDS 


binary | VSAM catalog Number of free data space extents on the affected volume 
volume entry after the data space is defined, extended, or deleted 
SMF6E9NUC binary | VSAM catalog Number of unallocated cylinders in all of the data spaces 
| volume entry on the volume | | 
SMF69SNUT 2 binary |VSAM catalog Number of unallocated tracks in all of the data spaces on 
volume entry the volume in addition to the number of unallocated 
cylinders 


N NO = 





£18 Ww Ww N 
NO > Oo f°?) 


N 
'?) 





‘SMF69LNC binary |VSAM catalog Number of cylinders in the largest continuous unallocated 
: volume entry area in any data space on the volume 
SMF69LNT binary [VSAM catalog | Number of tracks (in addition to the number of cylinders) 
volume entry in the largest continuous unallocated area in any data space 
on the volume 






ol 
ER: 


SMF69SCNM /EBCDIC |CAXCNAM Name of catalog in which the data space is defined 
(in IGGCAXWA) 
G4 § 


Name Tieid of VSAM! Voiume serial number of the volume on which the data 
catalog volume entry| space is defined 


cm 
i) 
© 


MF6OV/SR 


wwrewew ww t 





1The job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 
If a system task caused the record to be written, the job-name and user-identification fields contain blanks and the time and 
date fields contain zeros. - 
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Record Type 70 (46) — CPU Activity 


Record type 70 is written by ERBMFDCP for each measurement interval and when 
the session is terminated. It contains data that identifies each processor, its status, 
the amount of wait time that has taken place during an RMF reporting interval, 
and data describing address space utilization during an interval, as well as I/O inter- 
ruption measurements. Its length is 635 bytes plus 24 bytes for each processor 


included. 


The SMF record mapping macro for all records produced by RMF is: ERBSMFR. 
Its format is: ERBSMFR (nn(nn.. . .)) where nn identifies the types of the records 
you want to map. Note that the parentheses are required only when two or more 
record types are specified. The mapping macro resides in SYS1 .RMFMACO1. 


Cortese [Name [ven | Fone | Souee [SSC 
To [0 | awr7acen | 2 | vinary | ineemet | Recording SSCS 
[2 [2 [swereses [2 [rey [wrt [sone erin 


SMF 70FLG binary SMFWTM service System indicator 
Reine ] Meaning When Set 
. A subsystem ID follows the standard header; 
record is in relocatable format 
Subtype utilized 
-4. Reserved 
MVS/XA 
| VS2 
- Reserved 


Ed hl Raa ll bal sed leas 
routine SMF buffer 
BN eh 
routine OOyydddF, where F is the sign 

Tis[& | swrvosio | | eacbic| swcasio | Svs identification taken from S10 parame 
Crea | awrraesi |e [encore] inert | sutnn eriaion (RMP 
Daa | ie | swrrosty [2 | binary | ernst | Recordubupet SC 
[2e[ 1a | swrvoran | 2 | binary | inernat | Numberof wiplewinthsrecord? 
ras[ at —«d 2d nary | SC*dC Rees SSCS 
[2s | 1c | swrvopns | «| binary | meme | Offweso AMF proucteeton 
rse[ 20 | _swrvopme | 2 | inary | ieernel | Length of AM product ection = 
Tae [22 | _smr7oran | 2 | vinery | internal | Number of RMF productsecvions C= 
Tae [26 | sweroces [4 | inary | incernai | offer o CPU conwrotsection 
[ao [28 | smrvocce | 2 | winery | imernai | Length of CPU controlsection 
[az[ 2a | survocen [2 | sinary | imwrne! | Number of PU controlseevon 
[aa [2c | smrvoces [4 | binary | invernal | Offeetw CPU data section ——SSSCS~S 
Tae [a0 | smrvocee | 2 | binary | internal | Length of CPU data section SOS 
Tso] a2] swevocen | 2 | binory | internal | Number of CPU data sections inthinrecord 
[eae [ sweronss [74 [ sry [iret ot iden 
[6 [ae | smevoasc | 2 | inary | internat | Length of ASID data ection SOS 
se [aa smeroasn | 2 | sinary | internet | Number of ASIO data wctiong 


1A triplet is a set of offset/length/number values that defines a section of the record. 
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RMF Product Section: RMF version number. The contents of this field can be 
SMF70MFV 2 | any one of the following: 
— X’FOF1' for MF/1 
EDCDIC | internal X’FOF2’ for RMF Version 1 
X'FOF3’ for RMF Version 2, Release 1 or 2 
X’FOF4’ for RMF Version 2, Release 2 with 
MVS/System Extensions Release 1 installed 
X‘FOFD’ for either of the following: 
— RMF Version 2, Release 2 with MVS/System 
Extensions Release 2 installed 
— RMF Version 2, Release 3 
X‘'FOF6’ for RMF Version 2, Release 3 when either 
MVS/System Product-JES2 Release 1 Support Feature 
(5740/XYZ) or MVS/System Product—JES3 Release 1 
Support Feature (5740-XYN) is installed 
X'FOF7’ for RMF Version 2, Release 4 
X‘FOF8’ for RMF Version 2, Release 4 Enhancements 
X‘F3F1' for RMF Version 3, Release 1 
X‘F3F2’ for RMF Version 3, Release 2 
X‘321F' for RMF Version 3, Release 2 Modification 
Level 1 
X‘330F’ for RMF Version 3, Release 3 
X‘340F’ for RMF Version 3, Release 4 
X'341F’ for RMF Version 3, Release 4, Modification 
Level 1 
X'350F’' for RMF Version 3, Release 5 


For more information on the use of RMF, see Resource 
Measurement Facility (RMF) Reference and User’s Guide. 


‘packed internat 













| 2 | 2 | sme7opRD | 8 | escpic Product name (‘RMF’) 
SMF 70IST packed Time RMF measurement interval started, in the form 
OhhmmssF, where F is the sign 
14 SM70DAT packed internal Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 
SMF 70INT packed Duration of RMF measurement interval, in the form 
mmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the recorded start time and 
this field.) 
SSEMTOSAM binary internal (Set by Number of RMF samples 
oes 
| 28 | 1c | SMF70RV2 | 2 | binary binary | Reserved 
30 SMF 70FLA binary Flags 
Bit Meaning When Set 
0 Used internally by RMF post processor 
1-15 Reserved 
ial Sat SMF70RLS eo EBCDIC | CVTRELNO Operating system release number and level, in the form 
nnil 





24 SMF70CYC 4 packed internal Sampling cycie length, in the form OOOttttF, where F is 
the sign. 
40 28 SMF70MVS 8 EBCDIC | CVTPRODN MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 
48 30 SMF70IML 1 binary CSDIOML Indicates the type of processor complex on which data 


measurements were taken 


Value Meaning 

01 308x or 908x processor 
02 . 4381 processor 

03 3090 processor 


49 | 31 SMF70PRF 1 binary internal X‘80’ indicates the system has extended storage 
50 52. 2 Reserved 
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SY 


CPU Control Section: (continued) 
SMF70MOD packed CVTMDL Signiess CPU mode! number 


+2 SMF70VER 1 hook internal CPU version number — meaning varies with mode! 
number 


se 


CPU Data Section: Data is not collected for processors that were offline at the end of the measurement interval or that had any 
reconfiguration activity during the interval. 


+O | +0 SMF 7OWAT 8 binary LCCAWTIM (Set CPU wait time, where bit 51 = 1 microsecond. That is, 
by ERBMFDCP the amount of time that the CPU is not executing 
instructions (PSW wait state bit ison). Note: Data 
could be invalid if aSET CLOCK occurred during the 
RMF intarval. 


+10 SMF 70CNF binary internal Configuration activity indicator 
Bit Meaning When Set 
0-4 Reserved 
5 CPU reconfigured during post processor duration 
interval | 
CSDMICP 6 CPU reconfigured during the measurement interval. 
Data for this CPU is invalid 
SMF70STA CSDCPUAL CPU online at end of interval | 


Ce eS aT 
[a2 [re_[ smrrosen [2 | packed | PGCAPIO | ChU serialnumber 6 hexadecimal diane) ————d 
Tae [sF_| smeronve [1 [emery | id eed SCS 


SMF70SLH “ee PCCASLIH Number of entries to the 1/O SLIH; number of 1/O 


interruptions that this processor handled by entry 
into.the t/O interrupt handler. 

SMF70TPI | binary | PCCASTPI 

Hae So SM70VFS ae binary PSACROSV 


+28 SMF70V binary 
SMF70VON 


1-7 










SMF 70PAR 


SMF 70VAC 




















Number of TPI with CC=1; number of 1/O inter- 
-ruptions that this processor handled as a result 
of issuing the TP! instruction. 





Number of samples where the vector bit in the PSA image 
was on. 





internal Vector configuration. 
Bit Meaning when set 


@) Vector was online 
Reserved. 








(continued) 
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Ct el 


ASID Data Area Section: 


0 


136 
140 


144 | 


148 
152 
156 


6-168 


0 


Q Ba nN 


14 
18 
Cc 


6 FEBRBEBABTRS 


SMF7O0RMN 


SMF70RMM 
SMF70RTT 
SMF70RO00 
SMF70RO1 
SME70RO2 
SMF70RO3 
SMF70R04 
SMF70ROS 
SMF70R06 
SMF70R07 
SMF70RO08 
SMF70RO9 
SMF70R10 
SMF70R11 
SMF70R12 
SMF70R13 
SMF70R14 
SMF70R15 


SMF 70IMN 


SMF70IMM 
SMF7OITT 
SMF 70100 
SMF 70101 
SMF70102 
SMF70103 


SMF70104 


SMF70105 
SMF70106 
SMF 70107 
SMF70i08 
SMF701I09 
SMF70110 
SMF70111 
SMF700MN 
SMF700MM 
SMF 700TT 
SMF70070 
SMF 70001 
SMF70002 
SMF 70003 
SMF70004 
SMF70005 


> Pp PF Hh RB FANN SF FR & HP Hh & H SP S&F SH HS FF SN 


‘binary 


binary 


System Management Facilities (SMF) 


internal 


(Set by ERBMFECP) 


| internal 
(Set by ERBMFECP) 





Ready minimum value over interval 


Ready maximum value over interval 
Ready total value over interval 
Count of times ready value was 0 
Count of times ready value was 1 
Count of times ready vaiue was 2 
Count of times ready value was 3 
Count of times ready vaiue was 4 


Count of times ready vaiue was 5 


| Count of times ready value was 6 


Count of times ready value was 7 


Count of times ready vaiue was 8 


‘Count of times ready value was 9 


Count of times ready value was 10 - 


Count of times ready value was 11 


| Count of times ready value was 12 


Count of times ready vaiue was 13 
Count of times ready vaiue was 14 


Count of times ready value was 15 or more 


IN users minimum over interval 


IN users maximum over interval 
IN users total value over interval 
Count of times iN users was 0 
Count of times IN users was 1 or 2 


| Count of times IN users was 3 or 4 


Count of times IN users was 5 or 6 
Count of times IN users was 7 or 8 


Count of times IN users was 9 or 10 


Count of times IN users was 11 - 15 
Count of times IN users was 16 - 20 
Count of times IN users was 21 - 25 
Count of times IN users was 26 - 30 
Count of times IN users was 31 - 35 
Count of times IN users was 36 or more 
Out users minimum over interval 

Out users maximum over interval 

Out users total value over interval 
Count of times out users was 0 


f* wm, [eee 


1 Ned t oT tim@s Out users was i or Z 


Count of times out users was 3 or 4 
Count of times out users was 5 or 6 
Count of times out users was 7 or 8 
Count of times out users was 9 or 10 








| (continued) 














| Offsets Offsets 7 x Name | | Length | | Format | Sourca | 7 


ASID Data Area Section: (continued) 
_SMF70006 


160 
164 
168 
172 


176 
180 


184 
186 


| 188 


192 
196 
200 
204 
208 
212 


216 
220 


224 
228 
232 
236 
240 
242 
244 
248 
252 
256 


260 | 


264 
268 
272 
276 
280 
284 
288 
292 
296 
298 
300 
304 
308 
312 
316 
320 
324 


AO 
A4 
A8& 
AC 
BO 
B4 
B8 
BA 
BC 
CO 
C4 
C8 
CC 


| DO 


D4 


D8 


DC 


EO 
E4 
E8 
EC 
FO 
F2 
F4 
F8 


| FC 


128 
12A 


12¢ 


130 
134 
138 
13C 


144 


SMF 70007 
SMF 70008 
SMF 70009 
SMF 70010 
SMF700 11 
SMF 70WMN 
SMF 70WMIV 
SMF 7OWTT 
SMF 70W00 
SMF 70W01 
SMF70W02 
SMF70W03 
SMF 70W04 
SMF 70W05 


_SMF70W06 


SMF70W07 


SMF 70W08 
SMF 70W09 
SMF 70W10 
SMF 70W11 
SMF70BMN 
SMF 70BMM 
SMF 70BTT 
SMF70B00 
SMF70B01 
SMF 70B02 
SMF 70B03 
SMF70B04 
SMF 70B05 
SMF 70B06 
SMF 70B07 
SMF 70B08 
SMF 70B09 
SMF70B 10 
SMF70B11 
SMF70SMN 
SMF 70SMM 
SMF70STT 
SMF 70S00 
SMF70S01 
SMF70S02 
SMF 70S03 
SMF70S04 
SMF 70S05 


> hp $$ Hh hh fF RR RH PN NY FHF Hh FP A 


-& AF PF FP HA NN HR HP HLH HP PF HK Hh HLH Hh SF PB HFN NY Hh HA HL A 


binary 


binary 





internal 
(Set by ERBMFECP) 


internal 
(Set by ERBMFECP) 





Description 


Count of times out users was 11 - 15 


Count of times out users was 16 - 20 


| Count of times out users was 21 - 25 


Count of times out users was 26 - 30 
Count of times out users was 31 - 35 
Count of times out users was 36 or more 
Wait user minimum over interval 
Wait users maximum over interval 
Wait users total value over interval 
Count of times wait users was 0 
Count of times wait users was 1 or 2 
Count of times wait users was 3 or 4 
Count of times wait users was 5 or 6 
Count of times wait users was 7 or 8 
Count of times wait users was 9 or 10 


Count of times wait users was 11 - 15 
Count of times wait users was 16 - 20 


| Count of times wait users was 21 - 25 
‘Count of times wait users was 26 - 30 
| Count of times wait users was 31 - 35 


Count of times wait users was 36 or more 
Batch users minimum over interval 

Batch users maximum over interval 
Batch users total value over interval 
Count of times batch users was 0 

Count of times batch users was 1 or 2 


Count of times batch users was 3 or 4 


Count of times batch users was 5 or 6 


Count of times batch users was 7 or 8 
Count of times batch users was 9 or 10 
Count of times batch users was 11 - 15 
Count of times batch users was 16 - 20 
Count of times batch users was 21 - 25 
Count of times batch users was 26 - 30 
Count of times batch users was 31 - 35 
Count of times batch users was 36 or more 
Started users minimum over interval 
Started users maximum over interval 
Started users total value over interval 
Count of times started users was 0 
Count of times started users was 1 or 2 
Count of times started users was 3 or 4 
Count of times started users was 5 or 6 
Count of times started users was 7 or 8 


Count of times started users was 9 or 10 


(continued) 
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ortee [ norm [tons [Formet] sous 


ASID Data Area Section: (continued) 


328 
| 332 
| 336 
| 340 
| 344 
| 348 
| 352 
| 354 
| 356 
| 360 
364 
368 
372 


376 
| 380 
| 384 

388 
| 392 
| 396 
| 400 
) 404 

408 
| 410 
| 412 
416 


| 420 
‘| 424 
| 428 

432 
436 


| 440 


448 


| 452 










6-170 


148 
14C 
150 
154 
158 
15C 
160 
162 
164 
168 
16C 


170 


174 


178 
17C 
180 
184 


. 188 


18C 
190 
194 


198 
419A 


19C 
1A0 


1A4 


1A8 


1AC 


1BQ 


1B4 


1B8 


1BC 


1C0 


1C4 


SMF 70S06 
SMF70S07 | 
SMF 70S08 


~ SMF70S09 


SMF70S10 
SMF70S11 
SMF70TMN 
SMF 70TMM 
SMF 70TTT 
SMF 70T00 
SMF 70T01 


SMF70T02 © 


SMF70T03 


SMF70T04 
SMF70T05 
SMF70TOG6 
SMF70TO7_ 
SMF70T08 
SMF70T09 
SMF70T10 
SMEF70T11 
SMF70LMN 
SMF70LMM 
SMF70OLTT 
SMF70L00 
SMF70L01 
SMF70L.02 
SMF70L03 
SMF70L04 
SMF70L05 
SMF70L06 
SMF70L07 
SMF70L08 
SMF70L09 
SMF70L10 


SMF70L11 


& AB Sf A FF NH NH HA ABA HR A A 


4 


h& PN NY fF Sf Lh Hh hh hh A 


> 


A 














binary 
; 


: 


binary’ 


System Management Facilities (SMF) 





internal 
_ (Set by ERBMFECP' 








internal 


_(Set by ERBMFECP). 





Descript ion 


Count of times started users was 11 - 15 
Count of times started users was 16 - 20 
Count of times started users was 21 - 25 
Count of times started users was 26 - 30 
Count of times started users was 31 - 35 
Count of times started users was 36 or more 


TSO users minimum over interval 


TSO users maximum over interval 
TSO users total value over interval 
Count of times TSO users was 0 
Count of times TSO users was 1 or 2 
Count of times TSO users was 3 or 4 
Count of times TSO users was 5 or 6 


Count of times TSO users was 7 or 8 
Count of times TSO users was 9 or 10 
Count of times TSO users was 11 - 15 


| Count of times TSO users was 16 - 20 


Count of times TSO users was 21 - 25 
Count of times TSO users was 26 - 30 
Count of times TSO users was 31 - 35 
Count of times TSO users was 36 or more 
Logical ready users minimum over interval 


Logical ready users maximum over interval 


Logical ready users total value over interval 


Count of times the number of logical ready 
users was 0 


Count of times the number of logical ready 


| users was 1 or 2 


| Count of times the number of logical ready 


users was 3 or 4 


Count of times the number of logical ready 
users was 5 or 6 


| Count of times the number of logical ready 


users was 7 or 8 


Count of times the number of logical ready 
users was 9 or 10 


Count of times the number of logical ready 
users was 11 - 15 


Count of times the number of logical ready 
users was 16 - 20 


Count of times the number of logical ready 
users was 21 - 25 


Count of times the number of logical ready 
users was 26 - 30 


Count of times the number of logical ready 
users was 31 - 35 


Count of times the number of logical ready 
users was 36 or more 























C 








[ores [nome [emo 


| ASID Data Areas Section: (continued) 


464 
466 
468 
472 


476 


480 


| 488 
492 
496 
500 
504 
508 
512 


516 


1D0 
1D2 
1D4 


1D8 


1DC 


1E0 


1E4 


1E8- 


1EC 


1FO 


1F4 


1F8 


1FC 


200 


204 


SMF 70AMN 


SMF70AMM . 


SMF70ATT 
SMF 70A00 


SMF70A01 


SMF70A02 


SMF 70A03 


SMF 70A04 


SMF 70A05 


SMF 70A06 


SMF70A07 


SMF70A08 _ 


SMF 70A09 


SMF70A10 


SMF 70A11 


2 


2 
4 
4 


binary 


binary 





Source 





internal 
(Set by ERBMFECP) 


internal 
(Set by ERBMFECP) 


Logical wait users minimum over interval 
Logical wait users maximum over interval 
Logical wait users total value over interval 


Count of times the number of logical wait 
users was 0 


Count of times the number of logical wait 
users was 1 or 2 


Count of times the number of logical wait 
users was 3 or 4 


Count of times the number of logical wait 


-users was 5 or 6 


Count of times the number of logical wait 
users was 7 or 8 


Count of times the number of logical wait 
users was 9 or 10 


Count of times the number of logical wait 
users was 11 - 15 


Count of times the number of logical wait 
users was 16 - 20 


Count of times the number of logical wait 
users was 21 - 25 


Count of times the number of logical wait 
users was 26 - 30 


Count of times the number of logical wait 
users was 31 - 35 


Count of times the number of logical wait 
users was 36 or more 
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| Record Type 71 (47) — Paging Activity 





SMF71LEN 
an ee SMF71SEG 
4 | 4 SMF71FLG 
5 | 5 SMF71RTY 
6 | 6 SMF71TME 
10] A SMF71DTE 
14] E SMF71SID 
18 | 12 | SMF71SSI 
22| 16 | SMF71STY 
24| 18 | SMF7ITRN 
26 | 1A 
23 | 1C | SMEF71PRS 
32 | 20 | SMF7IPRL 
34 | 22 | SMF71PRN 
36 | 24 | SMF71PDS 

140 | 28 | SMF71PDL 
42:| 2A | SMF71PDN 
44 | 2c | sme7isws | 
48 | 30 | SMF71SWL 
50 | 32 | SmMF71SWN 


| RMF Product Section: 
0 0 


SMF71IMFV 


DM 
ris 


2 2 SME71D 


avout @ 










SMF 71IST 


SMF71DAT 


Record type 71 is written by ERBMFDPP for each measurement interval and when 
the session is terminated. It contains information about the demands made on the 
system paging facilities and the utilization of real storage and external page storage 
during the reporting interval. Its length is 540 bytes. 


For a description of the mapping macro, see record type 70. 


The format is: 


binary 
2 binary 
1 binary 


1 binary 
4 binary 


4 packed 


EBCDIC 
EBCDIC 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


rO po BP wH YB LHS NY NY KF NY NY YB HL HL 


binary 


2 EBCDIC/ 
packed 


packed 


internal 
internal 


SMFWTM service 
routine 


internal 


SMFEWTM service 
routine 


SMFWTM service 
routine 


SMCASID 
internal 
internal 


internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 
STSCMIV (in 


STSCT) 


internal 


internal 


Ce nee 


Record length 
Segment descriptor 
System indicator 


Bit Meaning When Set 


0 A subsystem !D follows the standard header; 
record is in relocatable format 

1 Subtype utilized 

2-4 Reserved 

5 MVS/XA 

6 VS2 

7 Reserved 


Record type: 71 (X‘47') 


Time, in hundredths of a second, when record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in the form 
OOyydddF, where F is the sign 


System identification (taken from SID parameter) 
Subsystem identification (‘RMF'‘) 
Record subtype=1 

Number of triplets in this record! 
Reserved 

Offset to RMF product section 

Length of RMF product section 
Number of RMF product sections 
Offset to paging data section 

Length of paging data section 

Number of paging data section 

Offset to swap placement data section 
Length of swap placement data section 


Number of swap placement data sections 


RMF version number. For more information on the 
version number, see the RMF version number descrip- 
tion in record type 70 and the Resource Measurement 
Facility (RMF) Reference and User’s Guide. 


ima awe rh 


Producti name ( rMivir ) 





Time RMF measurement interval started, in the form 
OhhmmssF, where F is the sign 


Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 


1a triplet is a set of offset/length/number values that defines a section of the record. 


6-172 System Management Facilities (SMF) 





a 














[ortsets | Name [Length | Format | source [| Deeription 


RMF Product Section (Cont): 


18 12 SMF711NT 4 packed internal Duration of RMF measurement interval, in the form 
mmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the record start time and this 


field. 
22 16 SMF71MFL 2 binary internal Record maintenance indication 
24 18 SMF71SAM 4 binary internal (Set by Number of RMF samples 
ERBMFEPG) 
28 1C SMF71RV2 2 binary Reserved 
30 1E SMF71FLA 2 binary internal Flags 
Bit Meaning When Set 
SMF71CNV 0 Used internally by RMF post processor 
SMEF71ISS 1 Samples have been skipped. Fields SMF71MNC, 
MXC, AVC, MNR, MXR and AVR contain 
data for less samples than the rest of the fields. 
The number of samples skipped is the sum of 
SMF711S1 and SMF711S2. 
2-15 Reserved | 
32 20 SMF71RLS 4 EBCDIC | CVTRELNO Operating system release number and level, in the form 
noll 
| 36 24 SMF71CYC 4 packed internal Sampling cycle length, in the form OOOttttF, where F is 
the sign 
| 40 28 SMF71MVS 8 EBCDIC} CVTPRODN MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 
48 | 30 SMF71IML 1 binary CSDIOML Indicates the type of processor on which data 
measurements were taken 
Value Meaning 
01 308x or 908x processor 
02 4381 processor 
03 3090 processor 
49 SMF71PRF 1 binary internal X‘80' indicates the system has extended storage 
50 | 52 2 | Reserved 
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Paging Data Section: 


+0 


+4 


+8 


+12 


+16 


+20 


+24 


+28 


+32 


+36 


+40 


+44 


+48 
+52 
+56 
+60 


+0 


+4 


+8 


+C 


+10 


+14 


+18 


+1C 


+20 


+24 


+28 


+2C 


+30 
+34 
+38 
+3C 


SMF71PIN 


SMF71POT 


SMF71PRC 


SMF71SSO 


SMF71SIN 


SMF71SOT 


SMF71VIN 


SMF71VOT 


SMF71VRC 


SMF71SNI 


SMF 71SNO 


SMF71SNR 


SMF71LNI 

SMF71LNR 
SMF71AFC 
SMF71TFC 






























RCETOTPI Number of non-VIO, non-swap page-ins. This field includes 
| page-ins required through page faults, specific page requests, 
and page fixes. It does not include page reclaims, page-ins 


for VIO data sets, and pages that are swapped in. 
RCETOTPO 





Number of non-VIO, non-swap page outs. This field 
includes page-outs required through specific page requests 
as well as those pages stolen by the paging supervisor as a 
result of infrequent use. It does not include page-outs for 
VIO data sets and pages that are swapped out. 





RCETOTRC Number of non-VIO, non-swap page reclaims. This field 
contains the number of requests for pages as a result of 
page faults, specific page requests, and page fixes that are 
satisfied without starting new page-ins. !t does not include 


those pages that are recovered by explicit VIO reclaim. 








RCENSWPS 










binary Number of address space swap sequences. (A swap sequence 


consists of an address space swap-Out and swap-in.) 








binary RCESWPPI Number of pages swapped in. This field includes: LSQA, 
fixed pages, and those pages that the real storage manager 
determined to be active when the address space was 


swapped in. It does not include page reclaims. 



















binary RCESWPPO Number of pages swapped out. This field includes: LSOA, 
private area fixed pages, and private area non-fixed changed 


pages. 





binary RCEVIOPI Number of VIO page-ins. This field includes page-ins 
resulting from page faults or specific page requests ona 
VIO window. It does not include VIO swap-ins or page-ins 


for the common area. 





RCEVIOPQ Number of VIO page-outs. This field includes page-outs 
resulting from specific page requests on a VIO window as 
well as those pages stolen by the paging supervisor as a 
result of infrequent use. It does not include VIO swap-outs 


or page-outs for the common area. 








RCEVIORU 





Number of VIO page reclaims. This field includes page 
reclaims required through a VIO request that was satisfied 
without page-in by means of the explicit VIO reclaim 

interface. 





binary RCECOMPI Number of non-ViO page-ins performed in common area 


(LPA/CSA). 







binary RCECOMPO 





Number of non-VIO page-outs performed in common area 
(LPA/CSA). 







binary RCECOMRC Number of non-V1O page reclaims performed in common 


area (LPA/CSA). 










RCELPAPI 
RCELPARC 
RCEAFC 
RCEPOOL 





binary Number of non-V1IO, non-swap page-ins performed in LPA. 







binary 





Number of non-V1IO, non-swap reclaims performed in LPA. 





binary Number of page frames available in real storage. 





binary Number of page frames defined in real storage. (This field 
does not include frames Occupied by the nucleus and 


frames marked as bad or offline.) 


(Continued) 
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re 


Paging Data Section: (continued) 


+64 
+68 


+72 


+76 


+80 


+84 
+82 
+92 
+96 


+100 


+104 


+108 


+112 


+116 


+120 
+124 
+128 


2 From the IARXCRME service routine 


+40 
+44 


+48 


+4C 


+50 


+54 
+58 


| +5C 


+60 


+64 


+68 


+6C 


+70 


+74 


+78 
+7C 
+80 


SMF71TSC 
SMF71DSC 


SMF71VSC 


~ SMF71NSC 


SMF 71FIN 


SMF71MNF 
SMF71MXF 
SMF71AVFE 
SMF71MNP 


SMF 71MXP 


SMF71AVP 


SMF71MNS 


SMF71MXS 


SMF71AVS 


SMF71MNT 
SMF 71MXT 


| SMF71AVT 


& HL fH FA 


binary 
binary 


binary 


binary 


binary 
binary 
binary 
binary 


| binary 


binary 


binary 


binary 


binary 
binary 


binary 


ASMSLOTS 
ASMVSC 


ASMNVSC 


ASMSLOTS- 
(ASMVSC + 
ASMNVSC + 
ASMERRS) 


(CVTDOFFE- 


CVTDOFFS)+ 


(CVTRWNE- 
CVTRWNS)+ 


(CVTERWNE- 
CVTERWNS)+ 


(CVTRONE- 
CVTRONS) 


RCEAFC 
RCEAFC 
RCEAFC 


RCECOMAL- 
LPA frames 2. 
SQA frames 


RCEOMAL- 


LPA frames @ - 


SOA frames 


RCECOMAL- 
LPA frames *- 
SOA frames 


RCEPOOL- 
RCEAFC- 
RCECOMAL- 


LSOA frames 


RCEPOOL- 
RCEAFC- 
RCECOMAL- 


LSOA frames 2 


RCEPOOL- 
RCEAFC- 
RCECOMAL- 
LSOA frames 


RCEPOOL 
RCEPOOL 
RCEPOOL 





Total number of local page data set slots. 


Number of local page data set slots allocated to VIO 
private area pages. 


Number of local page data set slots allocated to non-VIO 
private area pages. 


Number of usable local page data set slots that have not 
been allocated 


Number of frames in nucleus 


Minimum number of unused page frames 
Maximum number of unused page frames 
Average number of unused page frames 


Minimum number of CSA frames 


Maximum number of CSA frames 


Average number of CSA frames 


Minimum number of pageable address space frames in the 
private address space 


Maximum number of address space frames in the private 
address space . 


Average number of address space frames in the private 
address space 


Minimum total number of frames 
Maximum total number of frames 


Average total number of frames 


(Continued) 
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Paging Data Section: (continued) 
+132 
+136 
+140 | 
| +144 | 


+148 
| +152 


| +156 


-2Erom the IARXCRMF service routine 
3From the IARXCNTF service routine 


+84 
+88 


+8C | 
+90 


+94 


+98 


SMF71MNQ 
SMF71MXQ 
SMF71AVO 


SMF71MNC | 


SMF71MXC 


SMF71AVC 


SMF71MNR 


SMF71MXR 


SMF71AVR 


SMF71MNX 


SMF71MXX 
SMF71 AVX 


binary 
binary 
binary 


binary 


binary 


binary 


binary 


binary 


binary 


binary 
binary 
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SOA frames2 
SOA frames? 
SOA frames 


common fixed 
frames” 


common fixed 
frames® 


common fixed 
frames= 


RCETOTFX- 
SOA frames? - 
LSOA frames?- 
common fixed 
frames? 


RCETOTFX- 
SQA frames - 
LSQA frames2- 
common fixed 
frames? 


RCETOTFX- 
SOA frames2- 
LSOA frames2- 
common fixed 
frames? 


RCETOTFX 


RCETOTFX 
RCETOTFX 








Minimum number of SQA fixed frames 
Maximum number of SQA fixed frames 
Average number of SOA fixed frames 


Minimum number of CSA + LPA fixed frames 
Maximum number of CSA + LPA fixed frames 
Average number of CSA + LPA fixed frames 


Minimum number of non-LSOA fixed frames in the 
private address space 


Maximum number of non-LSOA fixed frames in the 
private address space 


Average number of non-LSQA fixed frames in the 
private address space 


Minimum total number of fixed frames 


Maximum total number of fixed frames 


Average total number of fixed frames 


(Continued) 


























Paging Data Section: (continued) 


+180 
+184 
+188 


+192 
+196 
+200 
+204 
+208 
+212 
+216 
+220 
| +224 
+228 
+232 


+236 


+238| 


+240 
+244 
+248 
+252 
+256 
+260 
+264 
+268 
+272 
+276 
+280 | 
+284 
+288 
+292 
[+296 


+B4 


+B8 


+BC 


+C0 


+C4 


+C8 


+CC | 


+D0 


+D4 
+D8 | 
+DC | 


+E0O | 


+E4 


+E8 |. 
(FEC : 
+EE | 


+FO | 


+F4 


+F8 
+FC | 


+100 
+104 
+108 


+10C| 


+110 
+114 
+118 


+11C] 
+120 | 


+124 
+128 


SMF71MNU 
SMF71MXU 
SMF71AVU 


SMF71MNV 
SMF71MXV 
SMF71AVV 

SMF71MNM 
SMF71MXM 
SMF71AVM 
SMF71MNB 
SMF71MXB 
SMF71AVB 

SMF71MNA 


SMF71MXA 


SMF711S1 
SMF711S2 


SMF7ITIS 
SMF71LWS 
SMF71DWS 
SMF71ULS 
SMF71NRS 
SMF71ASS 
SMF71RSS - 
SMF71EXS 
SMF71EES 
SMF71TOS 


~SMF71TXS 


SMF71LGS 
SMF71LFS 
SMF71LSS 
SMF71LSE 


4 


| binary 













Source 


ASMSLOTS- 
(ASMVSC + 
ASMNVSC + 
ASMERRS) 


ASMSLOTS- 
(ASMVSC + 

ASMNVSC + 
ASMERRS) 


ASMSLOTS- 
(ASMVSC + 

ASMNVSC + 
ASMERRS) 


>» ASMVSC 












binary 







| binary ASMVSC 







binary ASMVSC 







binary ASMNVSC 







binary ASMNVSC 






binary ASMNVSC 






binary ASMERRS 






binary ASMERRS 






binary ASMERRS 






| binary ASMSLOTS 









binary ASMSLOTS 


internal 





binary 





_internal 


Minimum number of usable local page data set slots that 
have not been allocated 


Maximum number of usable local page data set slots that 
have not been allocated 


Average number of usable local page data set slots that 
have not been allocated 


Minimum number of local page data set slots allocated to 
VIO private area pages 


Maximum number of local page data set slots allocated 
to VIO private area pages 


Average number of local page data set slots allocated to 
VIO private area pages 


Minimum number of local page data set slots allocated to 
non-V10O private area pages 


Maximum number of local page data set page slots allocated 
to non-V!O private area pages 


Average number of local page data set slots allocated to 
non-V1IO private area pages 


Minimum number of unusable local page data set 
slots 


Maximum number of unusable local page data set 
slots 


Average number of unusable local page data set 
slots 


Minimum total number of local page data set 
slots 


Maximum total number of local page data set 
slots 


Number of invalid samples skipped due to IARXCNTF. Fields 


_ affected are SMF 71MNC, MXC, AVC, MNR, MXR and AVR. 


_Number of invalid samples resulting from negative 


calculations. Fields affected are the same as SMF/7T1ISI. 


~ Reserved 


Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 


- Reserved 


Reserved 
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be 
Paging Data Section: (continued) 
+300 [+12C | SMF71NLP 4 binary LPA frames2 | Minimum number of LPA frames 
+304 +130 | SMF71XLP 4 binary LPA frames2 Maximum number of LPA frames 
+308 1+134 | SMF71ALP 4 binary LPA frames2 Average number of LPA frames 
+312 [+138 | SMF71NLF 4 binary LPA fixed frames2 | Minimum number of LPA fixed frames 
+316 14+13C | SMF71XLF 4 binary LPA fixed frames2 | Maximum number of LPA fixed frames 
+320 14140 | SMF71ALF 4 binary LPA fixed frames2 Average number of LPA fixed frames 
+324 1+144 | SMF71NLS 4 binary LSOA frames2 Minimum number of LSOA fixed frames 
+328 1+148 | SMF71XLS 4 binary LSQA frames2 Maximum number of LSQA fixed frames 
+332 1+14C | SMF71ALS 4 binary LSOA frames2 Average number of LSQA fixed frames 
+336 |+150 | SMF71IMNL 4 binary RCEBELFX Minimum number of fixed frames below 16 megabytes 
+340 1+154 | SMF71MXL 4 binary RCEBELFX Maximum number of fixed frames below 16 megabytes 
+344 1+158 | SMF71AVL 4 binary RCEBELFX Average number of fixed frames below 16 megabytes 
+348 1+15C | SMF71PMV 4 binary RCEPAGMV Total number of pages moved 
1} +352 ]}4+160 | SMF710OPT 8 EBCIDIC RMPTOPTN SRM opt member name 
+360 |1+168 | SMF71PES 4 binary RCEESWRT Total number of pages moved to extended storage 
+364 |+16C | SMF71PEA 4 | binary RCENWSF Total number of pages migrated from extended storage 
+RCEWSDNE to auxiliary storage 
+368 1+170 | SMF71AMN 4 binary RCEAEC Minimum number of available extended storage frames 
+372 [+174 | SMF71AMX 4 binary RCEAEC Maximum number of available extended storage frames 
+376 1+178 | SMF71ASA 4 binary RCEAEC Average number of available extended storage frames a 
+380 }+17C | SMF71LIC 4 binary MCVSTCRI Minimum high UIC : 
+384 1+180 | SMF71HIC 4 binary MCVSTCRI Maximum high UIC Soe 
+388 1+184 | SMF71ACA 4 binary MCVSTCRI Average high UIC (scale factor=—1) see note 1 
+392 [+188 | SMF71LMA 4 binary MCVMGAGE Minimum migration age; the time an unreferenced page 
remains in extended storage before migrating to auxiliary 
storage 
+396 |+18C | SMF71HMA 4 binary MCVMGAGE Maximum migration age; the time an unreferenced page 
remains in extended storage before migrating to auxiliary 
storage 
+400 |} +190 | SMF71AMA 4 binary MCVMGAGE Average migration age; the time an unreferenced page 
~ remains in extended storage before migrating to auxiliary 
storage (scale factor=—1) see note 1 
+404 1+194 | SMF71CF 4 SCCBNXSB* Number of installed extended storage frames 
SCCBMESI 
+408 |+198 | SMF71OLE 4 RCEESPL Number of online extended storage frames 
Swap Placement Section: (One per swap reason, located by SMF71SWS). See Note 2. 
0 0 SMF71TOT 4 binary RMCATOSC Total number of swap candidates 
4 4 SMF71AXD 4 binary SWCT Number of physical swaps directed to auxiliary storage 
8 8 SMF71LES 4 binary SWCT Number of logical swaps physically swapped to extended 
storage 
12 C SMF71LAX 4 binary SWCT Number of logical swaps physically swapped to auxiliary 
storage 
16 SMF71ESD 4 binary SWCT Number of physical swaps directly to extended storage 
20 SMF71MIG 4 binary SWCT Total number of physical swaps that migrated from gor 
extended storage to auxiliary storage ‘aa 
= » aed 


‘2From the |ARXCRMF service routine | : 


Note 1: Scale factor —1 means the field has been multiplied by 10 to give a result in tenths and must be multiplied by 107! to get the 
correct value. 
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Note 2: There are eleven swap placement sections, one per swap reason. If there were no swaps for a particular reason, its data fields 
contain zeroes. The sections are ordered as follows: 





Section number Reason 


Terminal output wait 
Terminal input wait 

Long wait 

Auxiliary storage shortage 
Real pageable storage shortage 
Detected wait 

Request swap 

Enqueue exchange 

Exchange on recommendation value 
Unilateral 

Transition to non-swappable 


“AO OOnN OOF WHND — 


—_ md 
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Record Type 72 (48) — Workload Activity 





data section. 


This record contains the PG number, number of PG periods, IPS name, 


Record type 72 is written by ERBMFDWP for each performance group 
(PG) defined in the installation performance specification (IPS). Type 
72 records are generated in the order of low to high PG number. Each 
record contains data on the one-to-eight PG periods for a PG number. 
Its length is 204 bytes plus 56 bytes for each performance group period 


number of terminated transactions, elapsed time of terminated trans- 


MSO, and SRB. 


For a description of the mapping macro, see record type 70. 


The format is: 


[ores [wine [tit [remat [ Sones ia 


SMF72LEN 2 binary internal Record length 
2 2 SMF72SEG 2 binary internal Segment descriptor 
4 4 SMF72FLG 1 binary SMFWTM System indicator 
Sores Bit | Meaning When Set 
pOnMNe 0 A subsystem ID follows the standard header; 
record in relocatable format 
1 Subtype utilized 
2-4 Reserved 
5 MVS/XA 
6 VS2 
7 Reserved 
SMF72RTY 1 binary internal Record type: 72 (X'48’) 
6 6 SMF72TME 4 binary SMFWTM service Time, in hundredths of a second, record was moved to 
routine SMF buffer 
10 A SMF72DTE 4 packed SMDWTM service Date record was moved to SMF buffer, in the form 
routine OOyydddF, where F is the sign 
14 E SMF72SID 4 EBCDIC | SMCASID System identification (taken from SID parameter) 
18 12 | SMF72SSI 4 EBCDIC | internal Subsystem identification ("RMF’) 
22 16 SMF 72STY 2 binary internal Record subtype=1 
24 18 SMF72TRN 2 binary internal Number of triplets in this pcona 
26 1A 2 binary Reserved 
28 1C SMF72PRS 4 binary internal Offset to RMF product section 
32 20 SMF72PRL 2 binary internal Length of RMF product section 
34 22 SMF72PRN 2 binary internal Number of RMF product section 
36 24 SMF72WLS ~4 binary internal Offset to workload control section 
40 28 SMF72WLL 2 binary internal Length of workload control section 
42 2A SMF72\WLN 2 binary internal Number of workload contro! sections 






sy wus ese Bn 





SMF 72PGS 
SMF72PGL 
SMF72PGN 


NO fs 


N 


1A triplet is a set of offset/length/number values that defines a section of the record. 
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actions, and active time, service and workload level of all transactions. 
Resource and service information is also provided on IOC, CPU, ERV, 


binary internal Offset to performance group period section 


binary internal Length of performance group period section 


binary internal Number of performance group period sections 








OS 
ri ' 
F iybe \ 
/ Wy 

i 
Lie 

gt 














RMF Product Section: 











SMF72MFV 


SMF72PRD 
SMF72IST 


SMF72DAT 


SMF72INT 


SMF72MFL 
SMF72SAM 
SMF72RV2 
SMF72FLA 


SMF 72CNV 
SMF721SS 


SMF72RLS 


SMF72CYC 


SMF72MVS 


SMF72IML 


SMF 72PRF 


| Workload Control Section: 


0 0 
2 2 
10 A 
14 E 
18 12 
22 16 
24 18 
28 1C 
30 LE 
32 20 
36 24 
40 28 
48 30 
49 31 
50 32 
+0 | +0 
+4 +1 

| +2 +2 
+4 +4 
+6 +6 
+14 | +E 
+17 | +11 
+20 | +14 
+26} +1A 
+30 | +1E 


SMF72FGI 


SMF 72RPT 
SMF 72CHF 


SMF72RV3 
SMF72SUB 
SMF72HPG 


SMF72IPS 
SMF72IRF 
SMF72CRF 
SMF72ERF 


SMF72ISD 


_ SMF72CSD 


MO NN fF N 


& fb DM W WwW OO 


EBCDIC/ 
packed 


EBCDIC 
packed 


packed 


packed 


binary 
binary 
binary 


binary 


EBCDIC 
packed 
EBCDIC 


binary 


binary 


binary 


binary 


binary 


EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 


EBCDIC 





internal 


internal 


internal 
internal 


internal 


internal 


internal 


internal 


CVTRELNO 
internal 
CVTPRODN 


CSDIOML 


internal 


internal . 


internal 


WAMTHPG 


WAMTIPS 
RMPTOPI 
RMPTOPC 
RMPTOPE 
WAMTIPI 
WAMTIPC 


RMF version number. For more information on the RMF 
version number, see the RMF version number description 
in record type 70 and the Resource Measurement Facility 
(RMF) Reference and User’s Guide. 


Product name 


Time RMF measurement interval started, in the form 
OhhmmssF, where F is the sign 


Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 


Duration of RMF measurement interval, in the form 
mmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the recorded start time and 
this field.) 


Record maintenance indication 
Number of RMF samples 
Reserved 

Flags 


Bit | Meaning When Set 

0 Used-internally by RMF post processor 
1 Samples have been skipped. 

2-15 Reserved 


Operating system release number and level, in the form 
nnll 

Sampling cycle length, in the form OOOttttF, where F is 
the sign 

MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


Indicates the type of processor complex on which data 
measurements were taken 


Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 


x‘80’ indicates the system has extended storage 


Reserved 


Flags 


Bit Meaning When Set 
0-4 Reserved 


5 Account information used 

6 Report class 

7 Change to performance sensitive variable was made 
Reserved 


Subcategory code, performance group (PG) number 


Highest PG number defined in installation performance 
specification (IPS) or installation control specification 
(ICS) 


Name of IPS 

1OC resource factor coefficient 
CPU resource factor coefficient 
ERV resource manager coefficient 


IOC service definition coefficient 


CPU service definition coefficient 
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Workload Control Section: (continued) 


+34 
+38 
| +42 
+50 
+58 


+62 


+72 


+82 


+92 


+22 
+26 
+2A 
+32 
+3A 


+3E 


+48 


+5C 


SMF72MSD 
SMF72SSD 
SMF720PT 
SMF72ICS 
SMF72SYS 


SMF72CLS 


SMF72USR 


SMF72NAM 


SMF72ADJ 


4 


E © © A 


10 


10 


4 


EBCDIC 


EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


binary 


Performance Group Period Data Section: 
+0 [+0 


+4 


+8 
+12 


+16 


+20 
+24 
+28 
+32 


+36 


+42 
+43 


+48 


+52 
+56 
+60 
+64 





+4 


+8 


+10 


+14 
+18 


“+1C 


+20 


+24 
+28 
+2A 
+2B 
+2C 
+30 


+34 
+38 
+3C 
+40 


SMF72TTX 
SMF72ACT 


SMF72SER 
SMF72TTM 


SMF72LEV 


SMF72MTS 
SMF72ITS 

SMF72CTS 
SMF72TAT 


SMF72SPP 
SMF72CON 
SMF72PON 
SMF72TSG 
SMF72STS 
SMFP72ETI 


SMF72ET2 
SMF 72PIN - 
SMEF72FT1 

SMF 72FT2 


4 
4 


> f fb f 


& & - - NY 


hb BR SH ff 


binary 
binary 


binary 
binary 


binary 


binary 
binary 
binary 


. binary 


binary 
binary 
binary 
binary 
binary 
binary 


binary 
binary 
binary 


binary 


WAMTIPM 
WAMTIPB 
RMPTOPTN 
AMPTICSN 


Symbolic name 


table 


Symbolic name 


table 


Symbolic name 


table 


Symbolic name 


table 


RMCTADJ 


WAMPTRN 


WAMPTAT 
(Set by 


IRARMWAR) 


WAMPSRV 


WAMPTET (Set by 
IRARMWAR) 


WAMPNWL., 


WAMPMSO 
WAMPIOC 

WAMPCPU 
WAMPTRR 


WAMPSWC 
WAMPOMN 
WAMPOBJN 
WAMPTSGN 
WAMPSRB 
WAMPETS 


WAMPETS 
WAMPPIR 
WAMPPRS1 
WAMPPRS2 
















Main storage service definition coefficient 
SRB service definition coefficient 
Name of [EAOQPTxx member 
Name of [EAICSxx member 


Name of subsystem associated with this PGN 
Name of class associated with this PGN 


User identifier associated with this PGN 


Name of transaction associated with this PGN 







CPU time per service unit (in microseconds), multiplied 
by 16. RMF uses this field to derive the number of service 
units per CPU second. 


Number of transactions terminated 


Active time of all transactions, in 1024-microsecond units. 
This field includes the total time that each transaction was 
in real storage pius any swapped-out time that the 
transactions were not in a long ‘‘wait"’ state. It does not 
include time between job steps for batch transactions. 


Service used in ail transactions, in service units. 


Elapsed time accumulated by ai! transactions that 
terminated in this PG period, in 1024-microsecond units. 


Workioad level of ail transactions, in units of 1/256 of a 
level 

Main storage total service units 

1/0 total service units ~ 
CPU total service units 


Transaction residency time, in 1024-microsecond units. 
This field does not include time between job steps for 
batch transactions. 


Number of swap sequences in period 
Domain number 

Performance objective number 

Time siice group number 

SRB total service units 


The first four bytes of the sum of the squares of the 
elapsed times accumulated by all ended transactions; 
this field is used to calculate standard deviation 


The second four bytes of the sum of the squares. 
Number of page-ins 


The first four bytes of the active frame-time 


The second four bytes of the active frame-time 


2 saan : 
“See Initialization and Tuning, for an explanation of how I/O service units are measured. 
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Record Type 73 (49) — Channel Path Activity 


Record type 73 is written by ERBMF e when channel path activity measurement 
is requested. Entries are created for all’channel paths in the system that are valid/ 
installed since RMF was started. However, report data is not formatted for channel 
paths that were offline at the end ofthe reporting interval or for channel paths that 
were reconfigured during the interval. Its length depends on the number of installed 
channels. 


The record contains identification information and channel path use data. 
For a description of the mapping macro, see record type 70. 


The format is: 


[ores [7 nene [te [remer [ Sere [ewe 


SMF73LEN internal Record length 
SMF 73SEG 
SMF 73FLG 










internal 


SMFWTM service 
routine 


Segment descriptor 





System indicator 























Meaning When Set 


0 A subsystem ID follows the standard header; 
record is in relocatable format 
1 Subtype utilized 
‘2-4 Reserved 
5 MVS/XA 
6 VS$2 


Reserved 
Record type: 73 (X‘49’) 








SMF 73RTY 
SMF 73TME 





internal 


SMFWTM service 
routine 


SMWTM service 
routine 


SMCASID 


binary 












binary Time, in hundredths of a second, record was moved 


to SMF buffer 























SMF73DTE Date record was moved to SMF buffer, in the form 


OOyydddF, where F is the sign 


packed 
























SMF 73S1D 
SMF73SS!1 
SMF73STY 
SMF73TRN 


EBCDIC 
EBCDIC 


System identification (taken from SID parameter) 





internal 





Subsystem identification (‘RMF’) 





binary internal Record subtype=1 





binary internal Number of triplets in this record! 





binary Reserved 





SMF73PRS 
SMF 73PRL 
SMF73PRN 
SMF73HIS 
SMF 73HIL 
SMF73HIN 
SMF 73HPS 
SMF73HPL 
SMF 73HPN 





internal 





binary Offset to RMF product section 





internal 





binary Length of RMF product section 













binary internal Number of RMF product section 





internal 





binary Offset to channel path control section 





binary internal Length of channel path control section 








binary Number of channel path control sections 





internal 





binary internal Offset to channel path data section 












binary internal Length of channel path data section 









NM NO FF NYO NO F NO NO HFS NYO NY NYO H FH 











binary internal Number of channel path data sections 










STSCMF1V 
(in STSCT) 


EBCDIC/ 
packed 


SMF73MFV 2 






RMF version number. For more information on the RMF 
version number, see the RMF version number description 
in record type 70 and the Resource Measurement Facility 
(RMF) Reference and User’s Guide. 


1A triplet is a set of offset/length/number values that defines a section of the record. 
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| RMF Product Section (continued): ‘ee 

2 2 SMF73PRD 8 EBCDIC | internal Product name 

10 A SMF731IST 4 packed internal Time RMF measurement interval started, in the form 
OhhmmssF, where F is the sign 

14 E SMF73DAT 4 packed internal Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 

18 12 SMF73INT 4 packed interval Duration of RMF measurement interval, in the form 
mmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the recorded start time and 
this field.) 

22 16 SMF73MFL 2 binary internal Record maintenance indication | 

24 18 SMF73SAM 4 binary internal Number of RMF samples 

28 | iC SMF73RV2 2 binary Reserved 

30 1E SMF73FLA 2 binary internal Flags 
Bit Meaning When Set _ - 

SMF73CNV 0 Used-internally by RMF post processor 
SMF73ISS 1 Samples have been skipped. 

2-15 Reserved 

32 20 SMF73RLS 4 EBCDIC | CVTRELNO Operating system release number and level, in the form 
nnll 

36 24 SMF73CYC 4 packed internal Sampling cycle length, in the form OOOttttF, where F is 


the sign (taken from CYCLE option). The range of values 
is 0.050 to 9.999 seconds. 


40 28 SMF73MVS 8 EBCDIC | CVTPRODN MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


48 30 SMF73IML 1 binary CSDIOML Indicates the type of processor complex on which data 
measurements were taken 


Value Meaning 


01 308x or 908x processor 

02 4381 processor 

03 3090 processor 
49 31 1 SMF73PRF 1 binary = {internal x‘80’ indicates system has extended storage 
+50] +51 2 _ Reserved 


Channel Path Control Section (one per record): 
SMF73SMP 





CPMTSAMP Number of times SRM issued STCPS to sample channel 







path busy; SRM OPT parmlib options. RMFTTOM sets 
the rate of STCPS. 





Channel Path Data Section (one per channel path): 
+0 +0 SMF73PID 1 binary lOCDS Channel path identification | 
+1 +4 SMF73FG2 1 binary 1OCDS Channel flags 


Bit Meaning When Set 
0-1 Reserved 





2 Block multiplexor 

3 Byte multiplexor 

4 Reserved 

5 Partial statistics 

6 Data recorded is invalid because channel path was 


reconfigured during interval 
Channel path is currently online 





binary Reserved 


SMF73BSY binary CMPTBUSY Number of samples in which the channel path was busy 
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Record Type 74 (4A) — Device Activity 





Record type 74 is written by ERBMFDDP for all devices specified in the DEVICE 
option. It contains entries for all devices that have been online at least once since 
RMF was started. The entry for any device that was offline at the end of the report- 
ing interval, or for any device that was taken offline during the interval, does not 
contain data. The length of record type 74 is 112 bytes plus 84 bytes for each 
device data section. Because the maximum length of an SMF record is 32,756 

| bytes, a maximum of 388 device data sections can fit in one record. 


This record identifies the sampling cycle length, number of samples, and the num- 
ber of devices. Each device entry contains the volume serial number (tape and 
direct access devices only), numbers of requests serviced on the device, the total 
active, pending, and connect time to service those requests, requests enqueued for 
the device, and the device number, class, and type, as well as other data collected 

| about the device. 





For a description of the mapping macro, see record type 70. 


The format is: 


SMF 74LEN binary internal Record length 
SMF74SEG 
SMF74FLG 


internal 


SMFWTM service 
routine 


binary Segment descriptor 


binary System indicator 


Meaning When Set 
ES , : A subsystem !D follows the standard 
( header; record is in relocatable format 
Subtype utilized 
Reserved 
| MVS/XA 
| VS2 


Reserved 
SMF74RTY Record type: 74 (X'4A’) 


SMF 74TME 


internal 
SMFEWTM service 


routine 


SMFEWTM service 
routine 


SMCASID 


binary 


binary Time, in hundredths of a second, record was moved 


to SMF buffer 


SMF 74DTE packed Date record was moved to SMF buffer, in the form 


OOyydddF, where F is the sign 
SMF74SID 
SMF74SSI 


EBCDIC 
EBCDIC 


System identification (taken from SID parameter) 


internal Subsystem identification ("RMF’) 





SMF 74STY 
SMF74TRN 


SMF74PRS 
SMF74PRL 
SMF74PRN 
SMF74DCS 
SMF74DCL 


SMF74DCN 
SMF74DDS 


SMF 74DDL 
SMF74DDN 


NO NON BP NM HO HF YO YM HB YB NYO NYO HL A 


binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 


internal 


internal 


internal 
internal 
internal 
internal 
internal 


internal 


internal 
internal 


internal 


Record subtype=1 


Number of triplets in this record | 


Reserved 

Offset to RMF product section 
Length of RMF product section 
Number of RMF product sections 
Offset to device control data section 
Length of device control data section 
Number of device contro! data section 
Offset to device data section 


Length of device data section 





Number of device data section 


1A triplet is a set of offset/length/number values that defines a section of the record. 
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ae a ~ 


€ | 
RME Product Section: Ve r 


0 0 SMF74MFV 2 EBCDIC/| STSCMFIV 
packed (in STSCT) 








RMF version number. For more information on the RMF 
version number, see the RMF version number description 
in record type 70 and the Resource Measurement Facility 
(RMF) Reference and User’s Guide. 


2 2 SMF 74PRD 8 EBCDIC | internal Product name 


10 A SMF 74IST 4 packed interval Time RMF measurement interval started, in the form 
OhhmmssF, where F is the sign 

14 E SMF 74DAT 4 packed internal Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 

18 12 SMF 741INT 4 packed Duration of RMF measurement interval, in the form 


internal 













mmsstttF, where F is the sign. (The end of the mea- 
surement interval is the sum of the recorded start time 
and this field.) 


22 16 SMF74MFL 2 binary 
24 18 SMF74SAM 4 binary 


internal Record maintenance indication 


internal (Set by Number of RMF samples 


(ERBMFEDV) 








28 1C SMF74RV2 2 binary Reserved 
30 1E SMF74FLA 2 binary internal Flags 
| - Bit Meaning When Set | 
SMF74CNV 0 Used-internally by RMF post processor 
SMF 7418S 1 Samples have been skipped. 

2-15 Reserved 

32 20 SMF74RLS 4 EBCDIC | CVTRELNO Operating system release number and level, in the form 
nnil 

36 24 SMF74CYC 4 packed internal Sampling cycle length, in the form OOOttttF, where F . ; 
is the sign (taken from CYCLE option). The range of See 
values is 0.050 to 9.999 seconds. 

40 28 © SM F74MVS 8 EBCDIC | CVTPRODN MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 

48 30 SMF74IML 1 binary CSDIOML Indicates the type of processor complex on which data 
measurements were taken 
Value Meaning 
01 308x or 908x processor 
02 4381 processor 
03 3090 processor 

49 | 31 SMF74PRF 1 binary internal x'80' indicates system has extended storage 

60 | 32 2 Reserved 

Device Control Data Section (one per record): 

+0 +0 SMF 74NXT 2 binary internal Number of device data sections in following records for 
this class 

+2 +2 SMF74TOT 2 binary internal Total number of device data sections in all records for 
this class 

+4 +4 SMF 74GEN 2 binary internal Total number of devices specified for all classes at system 

"generation 

+6 +6 SMF74SUB 2 binary UCBTBYT3 Device class code: 
Bit Configuration Meaning 
‘0080'X Magnetic tape device 
‘0040'X Communication equipment 
’0020'X Direct access devices f * 
0010'X Graphics devices F 
‘0008’ X Unit record devices 
‘0004'X Character reader devices 
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a 


Device Data Section (one per device): 


+0 
+2 
+4 
+5 


+6 


+12 
+16 
+20 
+24 


( * +28 
| +32 
+36 
+40 


+44 
+48 


+52 


+56 
+60 


+64 


+68 
+72 
+74 


+76 
+80 





+0 
+2 
+4 
+5 


+6 


+C 

+10 
+14 
+18 


+1C 
+2D 
+24 


+28 
+2C 
+30 


+34 


+38 
+3C 


+40 


+44 


+48 


+4A 


44C 


+50 


SMF74NUM 


SMF74LCU | 


SMF74RV3 
SMF74CNF 


SMF74QUL 
SMF74LCD 


SMF74CMB 


SMF74PAR 
SMF 74MXB 


SMF74VAC 


SMF74STA 
SMF74SER 


SMF74TYP 
SMF 74NUX 
SMF 74SSC 

SMF 74MEC 


SMF 74CNN 
SMF 74PEN 
SMF 74ATV 


SMF 74DIS 
SMF 74QUE 
SMF 74UTL 


SMF74RSV 


SMF74DSO 
SMF74ALC 


SMF74MTP 


SMF 74NRD 
SMF 74COF 


SMF741CT 


SMF74DVB 
SMF74CUB 


2 


2 
1 
1 


& LK DH FA 


Bay 





binary 
binary 
binary 
binary 


EBCDIC 


binary 
binary 
binary 


binary 


binary 
binary 


binary 


binary 
binary 


binary 
binary 


binary 


binary 


binary 


binary 
binary 
binary 


binary 


binary 


UCBNAME 
IOCDS © 


IOSUCNT routine 
1OCDS absent or 
unreadable 
internal 


internal 
UCBMTPXP and 
UCBBASE 
UCBONLI 


UCBONLI 
UCBVOLI 


UCBTYP 
UCBNEXP 
CMBSSCHC 
CMBSAMP 


CMBCONNT 
CMBPENDT 


CMBCONNT 
CMBPENDT 
CMBDISCT 


CMBDISCT 
{OSVCNT routine 


UCBRESVH 
UCBSTRT 


UCBRESVH 
UCBRESVP 


UCBDMC 
UCBALOC 


UCBMOUNT 
UCBALOC 
UCBNRY 


UCBNRY 
UCBDCTOF 


lLOCSTSQE 
(1OS Service) 


SCHMDTDB 
SCHMDTCB 





Device number, in the range X’0000' to X'OF FF’ 

Logica! control unit number, in the range X‘00’ to X’FF’ 
Reserved. Used internally. 

Device indicator 

Bit (Meaning When Set 


0 1OS queue length is invalid 
1 No logical control unit information 


CMB data is invalid 
Reserved 
Only partial statistics are available 
Device is a multiple exposure device; this is base 
exposure 

6 Data recorded is invalid because device was con- 
figured during interval 

7 Device is currently online 





Volume serial of the volume mounted on this device 
(tape or direct access device only) 


Unit type 


Number of exposures for a multiple exposure device 


Start subshannel count 


Measurement event count (number of SSCH instructions 
for which connect, pending, and active times were stored) 


Device connect time (in 128 microsecond units) 
Device pending time (in 128 microsecond units) 


Device active time (in 128 microsecond units) 


Device disconnect time (in 128 microsecond units) 
Number of requests queued in !OS for this device 


Number of samples when the device was reserved but an 
SSCH instruction had not been issued to the device 


Number of samples taken when the device was reserved 


Total number of data sets open on the device 


Number of samples taken that indicated that the device 
was allocated 


Number of samples taken that indicated a mount pending 
condition 


Number of samples taken that indicated that the device 
was not ready 


Number of requests that had hardware timer overflow 
for connect time measurement 


Number of invalid samples 


Device busy delay time, from SCHIB. 





Control unit busy delay time 
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Record Type 75 (4B) — Page/Swap Data Set Activity 





Record type 75 is written by ERBMFDSP at the end of each RMF measurement 
interval. One record is written for each page data set or swap data set monitored 
during the interval. It provides information on the use of auxiliary storage page 
slots, and the use of the page/swap data set by ASM. Its length is 200 bytes. 





For a description of the mapping macro, see record type 70. 


The format is: 


A a 18 Se SR _—___N 








SMF 75LEN binary internal Record length 
SMF75SEG binary internal Segment descriptor 
SMF75FLG binary SMWEFTM service System indicator 
routine Bit Meaning When Set 
0 A subsystem ID follows the standard 
header; record is in relocatable format 
1 Subtype utilized 
2-4 Reserved 
5 MVS/XA 
6 VS2 
7 Reserved 
| SMF75RTY | binary internal Record type: 75 (X’4B’) 
| SMF75TME binary SMFWTM service Time, in hundredths of a second, record was moved to 
| routine SMF buffer 
SMF75DTE packed SMFWTM service Date record was moved to SMF buffer, in the form : ON, 
routine OOyydddF, where F is the sign ‘ D 
| SMF75SID 4 EBCDIC | SMCASID | System identification (taken from SID parameter) _ 
SMF 75SS! 4 EBCDIC | internal Subsystem identification (‘RMF’) 
SMF75STY 2 binary internal i Record subtype=1 
SMF75TRN 2 binary internal Number of triplets in this record | 
2 binary Reserved 
! SMF75PRS 4 binary internal | Offset to RMF product section 
SMF 75PRL 2 binary internal Length of RMF product section 
SMF75PRN 2 binary internal Number of RMF product section 
SMF75PSS 4 binary internal Offset to page/swap data set data section 
SMF 75PSL Z binary internal Length of page/swap data set data section 
| SMF 75PSN 2 binary internal Number of page/swap data set data sections 
| RMF Product Section: 
| 
0 0 SMF75MFV 2 EBCDIC/ | STSCMF1V RMF version number. For more information on the RMF 
packed (in STSCT) version number, see the RMF version number description 
in record type 70 and the Resource Measurement 
Facility (RMF) Reference and User’s Guide. 
2 2 SMF75PRD 8 | EBCDIC | internal Product name 
10 A SMF 75IST 4 packed internal Time RMF measurement interval started, in the form 
OhhmmssF , where F is the sign 
14 E SMF 75DAT 4 packed internal Date RMF measurement interval! started, in the form 
OOyydddF, where F is the sign 
18 | 12 SMF 75INT 4 packed internal Duration of RMF measurement interval, in the form 


mmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the recorded start time and 
this field.) 





1A triplet is a set of offset/length/number values that defines a section of the record. 
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i 
22 


SMF75MFL Record maintenance indication 


24 18 SMF75SAM internal (Set by Number of RMF samples 


28 
30 


1C 
1E 


SMF 75RV2 


SMF75FLA 
SMF 75CNV 
SMF751SS 


SMF75RLS 


SMF75CYC 


SMF75MVS 


SMF75IML 


SMF 75PRF 


EBCDIC 


packed 


EBCDIC 


binary 


binary 


ERBMFESP) 


internal 


CVTRELNO 


internal 


CVTPRODN 


CSDIOML 


internal 


Reserved 


Bit Meaning When Set 

0 Used-internally by RMF post processor 
1 Samples have been skipped. 

2-15 Reserved 


Operating system release number and level, in the form 
nnil 


Sampling cycle length, in the form OOOttttF, where F is 


the sign (taken from CYCLE option). The range of 
values is 0.050 to 9.999 seconds. 


MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


Indicates the type of processor complex on which data 
measurements were taken 


Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 


X‘80’ indicates system has extended storage 


Reserved 
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Page/Swap Data Set Data Section: | 
EBCDIC | PARTDSNL or 


+0 +0 SMF75DSN 44 
SARDSNL 

+44 | +2C SMF 75PST 1 binary PARETYPE 

+45 | +2D SMF 75FL2 1 binary internal 

+46 | +2E SMF 75RV5 1 binary 

+47 | +2F SMF75TYP 4 binary UCBTYP 

+51 | +33 SMF75CHA 2 binary UCBNAME 

+53 [| +35 SMF75VOL 6 EBCDIC | UCBVOLI 

+59 | +3B SMF75RV3 5 binary 

+64 | +40 SMF75SLA 4 binary PARESZSL or 
SRETOTSL 

+68 | +44 SMF75MXU 4 binary (PARESZSL - 
PARESLTA) or 
(SRETOTSL - 
SREAVLSL) 

+72 | +48 SMF75MNU 4 binary (PARESZSL - 
PARESLTA) or 
(SRETOTSL - 
SREAVLSL) 

+76 | +4C SMF 75AVU 4 binary (PARESZSL - 
PARESLTA) or 
(SRETOTSL - 
SREAVLSL) 

+80 | +50 SMF75BDS 4 binary PARERRCT or 
SRERRCT 

+84 | +54 SMF75USE 4 binary IORFUSE 

+88 | +5A SMF 75REQ 4 binary IORFUSE 

+92 | +5C SMF 75S10 4 binary IORSION 

+96 | +62 SMF 75PGX 4 binary lIORTREQ 


SMF75RV8 
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Page/swap data set name 


Page space type 


Bit Meaning When Set 

0 PLPA 

1 COMMON 

2 DUPLEX 

3 LOCAL 

4 SWAP 

5 Data set unusable 

6 Data set came online during interval 
7 Reserved 

Flags 

Bit |Meaning When Set 

0 Data set accepts VIO pages 

1 Data set on multiple exposure device 
2 Data set on device with alternate control unit 
3-7 Reserved 

Reserved 

Unit type 


Device number in the form hhhF, hex digits followed 
by F 


Volume serial number 
Reserved 


Total number of slots or swap sets contained within the 
page or swap data set 


Maximum number of slots used or maximum number of 
swap sets used 


Minimum number of slots used or minimum number of 
swap sets used 


Average number of slots used or average number of swap 
sets used 


Number of unusable slots or unusable swap sets 


Number of samples indicating data set was being used by 
ASM 


Number of requests for the data set observed during RMF 
sampling. For single exposure devices, this is the same as 
SMF75USE. For multiple exposure devices, this value is 

the sum of all outstanding requests on all exposures. 


Number of !/O requests for the data set 
Number of pages transferred to or from page data set 


Reserved 

















Record Type 76 (4C) — Trace Activity 





Record type 76 is written by ERBMFDTP at the end of each measurement interval. 
One record is written for each field name sampled during the interval. Record type 

76 contains information on the number of samples, the number of sets, (lines of data), 
the minimum value of the field, the maximum value of the field, the sum of the 
squared values of the field, and the final value sampled from the field. The trace values 
collected for each set are grouped at the end of the record. The length of record type 
76 is 166 bytes plus 2 or more bytes for the length of the variable trace data section. 


aa ee a eer 















SMF 76LEN internal Record length 
SMF 76SEG 


SMF76FLG 


binary 












internal 


SMFWTM service 
routine 


binary Segment descriptor 











binary System indicator 
















Meaning When Set 


0 A subsystem ID follows the standard header; 
record is in relocatable format 

1 Subtype utilized 

2-4 Reserved 

5 MVS/XA 

6 VS2 


Reserved 
Record type: 76 (X‘4C’‘) 










SMF76RTY 
SMF 76TME 





internal 


SMFWTM service 
routine 


SMFWTM service 
routine 


SMCASID 


binary 
















binary Time, in hundredths of a second, record was moved to 


SMF buffer 















SMF76DTE packed Date record was moved to SMF buffer, in the form 


OOyydddF , where F is the sign 

































SMF 76SID 
SMF 76SS! 
SMF 76STY 
SMF76RTN 


EBCDIC 
EBCDIC 


System identification (taken from SID parameter) 











internal Subsystem identification (‘RMF’) 










binary internal Record subtype=1 





Number of triplets in this record | 





binary internal 





binary Reserved 







SMF 76PRS 
SMF 76PRL 
SMF 76PRN 
SMF76TCS 
SMF76TCL 
SMF76TCN 
SMF76TDS 
SMF76TDL 
SMF76TDN 
SMF76VFS 
SMF76VFL 
SMF76VFN 





binary internal Offset to RMF product section 





internal 





binary Length of RMF product section 





internal 






binary Number of RMF product section 










binary internal Offset to trace control section 





binary internal Length of trace control section 









Number of trace control sections 





binary internal 





binary internal Offset to trace data entry section 










binary internal Length of trace data entry section 








binary internal Number of trace data entry sections 














binary internal Offset to variable format set 





binary internal Length of variable format set 










BND BN NY BN HY BNHOND BH NY ND HB A 








binary internal Number of variable format sets 





SMF 76MFV STSCMFIV 


(in STSCT) 


EBCDIC/ 
packed 


RMF version number. For more information on the RMF 
version number, see the RMF version number description 
in record type 70 and the Resource Measurement Facility 
(RMF) Reference and User’s Guide. 



















SMF76PRD 
SMF76IST 


EBCDIC internal Product name 





Time RMF measurement interval started, in the form 
OhhmmssF, where F is the sign 


packed internal 


1A triplet is a set of offset/length/number values that defines a section of the record. 
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RME Product Section (continued): 


14 


18 


22 
24 
28 
30 


32 


36 


40 


48 


49 
50 


E 


12 


20 


24 


28 


31 
32 


SMF 76DAT 


SMF 76INT 


SMF 76MFL 
SMF76SAM 
SMF76RV2 
SMF76FLA 


SMF 76CNV 
SMF 76ISS 


SMF76RLS 


SMF76CYC 


SMF76MVS 


SMF76IML 


SMF76PRF 


Trace Control Section: 


+0 | +0 SMF 76NUM 
‘+42 1 +2 SMF 76RV4 

Trace Data Section: 

+0 | +0 SMF 76NAM 

+8 +8 SMF 760PT 





4 


4 


wm NO & NH 


1 


packed 


packed 


binary 
binary 
binary 
binary 


EBCDIC 


packed 


| EBCDIC 


binary 


binary 
binary 


EBCDIC | MFTRTRAC 
ERBMFETR 


binary 
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internal 


internal 


internal 
ERBMFETR 


internal 


CVTRELNO 


internal 


CVTPRODN 


CSDIOML 


internal 


Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 


Duration of RMF measurement interval, in the form — 
mmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the recorded start time and 
this field.) 


Record maintenance indication 
Number of RMF samples 
Reserved 

Flags 


Bit (Meaning When Set 

0 Used-internally by RMF post processor: 
1 Samples have been skipped. 

2-15 Reserved 


Operating system release number and level, in the form 
nnil 


Sampling cycle length, in the form OOOttttF, where F is 
the sign (taken from CYCLE option). The range of 
values is 0.050 to 9.999 seconds. 


MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


Indicates the type of processor complex on which data 
measurements were taken 


Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 


X'80' indicates system has extended storage 


Reserved 


Number of sample sets (lines of data) in the trace 


Reserved 


Field name 
Trace options 


Bit Meaning When Set 


0 Minimum value of the field is contained in the 
SMF record 

1 Maximum value of the field is contained in the 
SMF record 

2 The sum of the values required to calculate the 
average of the field is contained in the SMF record 

3 The sum of the squared values required to calculate 


the standard deviation of the field is contained in 
the SMF record 

4 End value of the field is contained in the SMF 
record 
All options selected 


Domain tracing terminated 
This entry is a domain field 











F, 
ev 








CR rintion —C*d 





Trace Data Section: (continued) 
+9 =| +9 SMF 760P1 1 binary ERBMFETR Trace options 


Bit (Meaning When Set 
! 0 LPB trace requested 
| 1 LPB trace request ended 
! 2-7 Reserved 


SMF76SLN 
SMF76DLN 
SMF76SSS _ | 
SMF 76SSL 
SMF 76MIN 
SMF 76MAX 
SMF76AVG 
SMF76STD 
SMF 76ENV 


ooh 


binary Length of a set 

binary ERBMFETR Length of a field sampled 
binary ERBMFETR Standard samples per set used 
binary Samples per set 

binary ERBMFETR Minimum value during interval 
binary ERBMFETR Maximum value during interval 


Oo fF FN NO — 


binary ERBMFETR Accumulated value used to compute the average 


—_ 
NO 


binary ERBMFETR Sum of squares (used to compute standard deviation) 
binary ERBMFETR End value of field | 


f 


Variable Trace Data Section: 


SMF76C or ERBMFETR Trace values collected for each set, stored in an array of 

SMF 76D either fullwords or halfwords, depending on the length of 
the field being sampled (SMF 76C if fullwords; SMF 76D if 
halfwords). There will be one group of values for each 
sample set (line of data) in the trace 


Length of data in bytes and relative 


| aS Size of position in array 
| ( Array 


Element] Min. | Sum of | Max. | Sum of 
in Bytes | Value} Values | Value] Sq. Vals} Value 
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Record Type 77 (4D) — Enqueue Activity 


Record type 77 is written by ERBMFDEQ at each measurement interval and when 
the session is terminated. It contains data that identifies the resources for which 
ENQ/DEQ contention occurred during the measurement interval and data that 
describes any contention that occurred. Its length is 106 bytes, plus 156 bytes for 
each resource for which data was gathered. | | 


For a description of the mapping macro, see record type 70. 


The format is: 


Record Type 77 (4D) — Enqueue Activity 


[offsets [Name [Length | Format | Source [| —————~—SiDesoriptlon ——SSCSC~SCS 





OOyydddF, where F is the sign 


\ 
4 


0 0 SMF77LEN | 2 binary internal Record length 
2 2 SMF77SEG 2 binary internal Segment descriptor 
4 4 SMF77FLG 1 binary SMFWTM service System indicator 
routine Meaning When Set 
A subsystem ID follows the standard header; 
record is in relocatable format 
Subtype utilized 
Reserved 
MVS/XA 
VS2 
Reserved 
SMF77RTY | 1 binary internal Record type: 77 (X’4D’) 
6 | SMF77TME 4 binary SMFWTM saervice Time, in hundredths of a second record was moved to 
routine SMF buffer 
10 A SMF77DTE 4 packed SMFWTM service Date record was moved to SMF buffer, in the form a 
| routine OOyydddF, where F is the sign . 
14 E SMF77SiID 4 EBCDIC | SMCASID System identification (taken from SID parameter) 
18 | 12 SMF77SSI 4 EBCDIC | internal Subsystem identification ("RMF’) 
22 | 16 SMF77STY 2 binary internal Record subtype=1 
24 | 18 SMF77TRN 2 binary internal Number of triplets in this record l 
26 1A 2 | binary Reserved 
28 | IC | SMF77PRS — 4 binary internal Offset to RMF product section 
32 20 SMF77PRL 2 binary internal Length of RMF product section 
34 22 SMF77PRN 2 binary internal Number of RMF product section 
36 24 SMF77EQS 4 binary internal Offset to enqueue control section 
40 28 SMF77EQL 2 binary internal Length of enqueue control section 
42 2A SMF77EQN 2 binary internal Number of enqueue control sections 
44 2C SMF77EDS 4 binary internal Offset to enqueue data section 
48 30 SMF77EDL 2 binary internal Length of enqueue data section 
50 32 SMF77EDN 2 binary internal Number of enqueue data sections 
RMF Product Section: 
0 0 SMF77MFV 2 EBCDIC/| STSCMF1V RME version number. For more information on the RMF 
packed (in STSCT) version number, see the RMF version number description 
in record type 70 and the Resource Measurement Facility 
(RMF) Reference and User’s Guide. 
2. hs oe SMF77PRD EBCDIC | internal Product name 
10 | A SMD771ST 4 packed internal Time RMF measurement interval started, in the form 7 
OhhmmssF, where F is the sign ff 
14 E SMF77DAT 4 packed internal Date RMF measurement interval started, in the form .e 


Tp triplet is a set of offset/length/number values that defines a section of the record. 
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[ortsets [Name [tength [Format | Source | ——=S~S~S~=Saseription 


RMF Product Section (continued): 





18 12 SMF77INT 4 packed internal Duration of RMF measurement interval, in the form 
mrmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the recorded start time and 


this field.) 

22 16 SMF77MFL 2 binary internal Record maintenance indication 

24 18 SMF77SAM 4 binary internal Number of RMF samples 

28 1C SMF77RV2 2 binary Reserved 

30 1E SMF77FLA 2 binary internal Flags 
Bit | Meaning When Set 

SMF77CNV 0 Used-internally by RMF post processor 
SMF77ItSS 1 Samples have been skipped. 

2-15 Reserved 

32 20 SMF77RLS 4 EBCDIC; CVTRELNO Operating system release number and level, in form nnil 

36 24 SMF77CYC 4 packed internal Sampling cycle length, in the form OOOttttF, where F is 
the sign (taken from CYCLE option). The range of 
values is 0.050 to 9.999 seconds. 

40 28 SMF77MVS 8 EBCDIC! CVTPRODN MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 

48 30 SMF77IML 1 binary CSDIOML — Indicates the type of processor complex on which data 
measurements were taken 
Value Meaning 
01 308x or 908x processor 
02 4381 processor 
03 3090 processor 

( 49 | 31 SMF77PRF 1 X‘80’ indicates system has extended storage. 
+50. 32 2 Reserved 


Enqueue Control Section: 
SMF77FG1 







binary internal Enqueue status indicator 


Meaning 
On — enqueue summary table full 
On — specified resource had no contention 


On — enqueue had bad CPU clock 

On — enqueue event processing abend 
On — detail data requested 

Off — summary data requested 
Reserved 





SMF77RF2 Reserved 
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‘Enqueue Data Section: 


+0 

+8 

+52 
+56 
+60 
+64 
+66 
+68 
+70 
+72 
+74 
+76 
+78 
+80 
+82 
+84 


+86 
+87 


+88 
+90 
+92 
+100 
+108 
+116 
+124 
+132 
+140 


+148 


+0 

+8 

+34 
+38 
+3C 
+40 
+42 
+44 
+46 
+48 
+4A 
+4C 
+4E 
+50 
+52 
+54 


+56 
+57 


+58 
+5A 
+5C 
+64 
+6C 
+74 
+7C 
+84 
+8C 


+94 


SMF770NM 
SMF77RNM 
SMF77WTM 
SMF77WTX 
SMF77WTT 
SMF77RV3 
SMF77QL1 
SMF77QL2 
SMF77QL3 
SMF770L4 
SMF77QLT 
SMF77EXM 
SMF77EXX 
SMF77SHM 
SMF77SHX 
SMF77EVT 


SMF77RLN 
SMF77DFG 


SMF77D0W 
SMF77DWR 
SMF77D01 
SMF77D02 
SMF77DW1 
SMF 77DW2 
SMF77SY 1 
SMF 77S Y2 
SMF 77S Y3 


SMF77SY4 


oo Lee) 10.0) oO ee) 0 CO 0 


EBCDIC 
EBCDIC: 
binary 
binary 
binary 
binary 
binary 
binary 
‘binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 
binary 


binary 
binary 
EBCDIC 


EBCDIC 
EBCDIC 


EBCDIC 


EBCDIC 
EBCDIC 
EBCDIC 


EBCDIC 
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RIBQNAME 
RIBRNAME 
internal 


internal 


internal 
internal 
RIBNTWE + 
RIBNTWS 
RIBNTWE + 
RIBNTWS 
RIBNTWE + 
RIBNTWS 
RIBNTWE + 
RIBNTWS 
RIBNTWE + 
RIBNTWS 
RIBNTWE 
RIBNTWE 
RIBNTWS 
RIBNTWS 
internal 


RIBRNMLN 
internal 


internal 
internal 
RIBEJBNM 
RIBEJBNM 
RIBEJBNM 
RIBEJBNM 
RIBESYSN | 
RIBESYSN 
RIBESYSN 


RIBESYSN 


Major name of resource 


| Minor name of resource 


Minimum resource contention time, in 1024-microsecond 
units 

Maximum resource contention time, in 1024-microsecond 
units 

Total resource contention time, in 1024-microsecond units 
Reserved 

Counter for queue length of 1 


Counter for queue length of 2 


Counter for queue length of 3 


Counter for queue length of 4 or more 


Total number of waiting requests during the measurement 
interval 

Minimum number of exclusive requests waiting 

Maximum number of exclusive requests waiting 

Minimum number of share requests waiting 

Maximum number of share requests waiting 


‘Total number of contention events that occurred during 


the measurement interval 
Minor name length 
Current resource detail indicator 


Bit Meaning When Set 


0 On — resource still in contention 

1 On — scope of systems 
Off — scope of system 

2 On — owner has exclusive control of the resource 
Off ©— owner shares the resource 

3 On — first job is waiting for exclusive use 
Off — first job is waiting for shared use 

4 On -— second job is waiting for exclusive use 
Off | — second job is waiting for shared use 

5 On — resource is global 
Off — resource is local 


6-7 Reserved 

Number of owners using the resource at maximum 
contention 

Number of jobs waiting for the resource at maximum 
contention 

Job name 1 of resource owner at maximum contention 
Job name 2 of resource owner at maximum contention 
Job name 1 waiting for the resource at maximum 
contention 

Job name 2 waiting for the resource at maximum 


i contention 


System identifier of job name 1 (resource owner at 
maximum contention) 

System identifier of job name 2 (resource owner at 
maximum contention) 

System identifier of job name 1 (waiting for the resource 
at maximum contention) 

System identifier of job name 2 (waiting for the resource 
at maximum contention) 


























Record Type 78 (4E) Monitor I Activity 





Record type 78 has three sub-types and is written by ERBMFDOQ (sub-type 1), 
ERBMFDVP (sub-type 2) or ERBMFDGQ (sub-type 3) during a Monitor I session. 
Sub-type 1 and sub-type 3 report I/O queuing activity and contain an entry for 

each logical contro] unit that had any activity during the interval. Sub-type 2 reports 
virtual storage activity and contains acommon storage data section and possibly 

one or more private area data sections. 





The record has a standard SMF header and product section that are common to both | 
sub-types. The length of record type 78 depends on the sub-type. For sub-type 1 the | 
length is 108 bytes plus 56-92 bytes for each logical control unit. For sub-type 2, 

the minimum length is 1836 bytes if no private area data is included. Otherwise, 

the length is 1836 bytes plus at least 392 bytes for each private area that is 

monitored. For sub-type 3, written only when RMF is measuring data on a 3090 

processor, the length is 108 bytes plus 60-96 bytes for each logical control unit. 


For a description of the mapping macro, see record type 70. 


The format is: 


SMF78LEN binary internal Record length 
SMF78SEG binary internal Segment descriptor 
SMF78FLG binary SMFWTM service System indicator 


Deas routine j Meaning When Set 

( A subsystem ID follows standard header; record 
is in relocatable format 
Subtype utilized 
Reserved 
MVS/XA 
VS2 
Reserved 


SMF78RTY 1 binary internal Record type 78 (X’'4E’) 


SMF78TME binary SMFWTM service Time in hundreths of a second when record was moved 
routine to SMF buffer 


SMF78DTE packed SMDWTM service Date record was moved to SMF buffer, in the form 
routine OOyydddF where F is the sign 


SMF78SID 
SMF78SS] 
SMF78STY 
SMF78TRN 


EBCDIC | SMCASID System identification (taken from SID parameter) 
EBCDIC | internal Subsystem identification (‘RMF’) 

binary internal Subtype 

binary internal Number of triplets in record u 

binary Reserved 
SMF78PRS 

. SMF78PRL 
SMF78PRN 
SMF78DCS 
SMF78DCL 
SMF78DCN 
SMF78ASS 
SMF78ASL 
SMF78ASN 


1A triplet is a set of offset/length/number values that defines a section of the record. 


binary internal Offset to RMF product section 
binary internal Length of RMF product section 
binary internal Number of RMF product sections 
binary internal Offset to data control section 
binary internal Length of data control section 
binary internal Number of data contro! sections 


binary internal Offset to data section 


MO FP NM NH FP DY NYO BS YN NY NY HL FA 


binary internal Length of data section 





NO 





binary internal Number of data sections 
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The following three fields apply only to sub-type.2: 
+52 
+56 


+58 


+34 


+38 


+3A 


SMF78SPS 


SMF78SPL 


SMF78SPN 


4 


2 


2. 


binary 
binary 


binary 


internal 


internal 


internal 





Description 


Offset to private area subpool section 
Length of private area subpool section 


Number of private area subpool sections 


The following three fields apply only to sub-type 3, written when RMF is running on a 3090 processor. 


| +52 
+56 
+58 


+34 
+38 
+3A 


SMF78QDS 
SMF780QDL 
SMF78QDN 


RMF Product Section: 


0 


14 


18 


22 
24 


28 
30 


32 


36 


40 


48 


49 
50 
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0 


12 


16 
18 


1C 
1E 


20 


24 


28 


30 


31 
32 


SMF78MFV 


SMF78PRD 
SMF78IST 


SMF 78DAT 


SMF78INT 


SMF78MFL 
SMF78SAM 


SMF78RV2 
SMF78FLA 


SMF 78CNV 
SMF 78ISS 


SMF78RLS 


SMF78CYC 


SMF78MVS 


SMF78IML 


SMF 78PRF 


NO 


binary 
binary 
binary 


EBCDIC/ 
packed 


EBCDIC 
packed 


packed 


packed 


binary 


binary 


binary 


binary 


EBCDIC 


packed 


EBCDIC 


binary 


binary 


System Management Facilities (SMF) 


internal 
internal 


internal 


STSCMF1V 
(in STSCT) 


internal 


internal 


internal 


internal 


internal 


internal 


internal 


CVTRELNO 


internal 


CVTPRODN 


CSDIOML 


internal 


Offset to 10Q global section. 
Length of 10Q global section 
Number of 100 global section 


RMF version number. For more information on the 
version number, see the RMF version number descrip- 
tion in record type 70 and the Resource Measurement 
Facility (RMF) Reference and User’s Guide. 


Product name 


Time RMF Monitor | measurement interval started, in 
the form OhhmmssF, where F is the sign 


Date RMF Monitor | measurement interval started, in 
the form OOyydddF, where F is the sign 


Duration of RMF Monitor | measurement interval, in 

the form mmsstttF where F is the sign. (The end of the 
measurement interval is the sum of the recorded start , 
time and this field.) = 


Record Maintenance Indication 


Number of RMF samples. This field is used to 
calculate the averages for the common storage data 
section fields. 


Reserved 
Flags 


Bit Meaning When Set 

0 Used-internally by RMF post processor 
1 Samples have been skipped. 

2-15 Reserved 


Operating system release number and level, in the form 
nol 


Sampling cycle length, in the form OOOttttF, where F is 
the sign (taken from CYCLE option). The range of 
values is 0.050 to 9.999 seconds. 


MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


Indicates the type of grocessor complex on which data 
measurements were taken 


Value Meaning 
01 308x or 908x processor 
O02 4381 processor 


03 3090 processor 


X‘80’ indicates system has extended storage 


Reserved 


























Ottets [Name [ tonath | Format | Sowee [——~S~S~—=i serio 


| Sub-type 1 1/O Queuing Control Section for the 308x, 908x, and 4381 processors: (one per LCU, described by triplet SMF78DCS) 





+0 +0 R7811D1 2 binary internal Logical control unit identifier 


+2 +2 R781NTR 2 binary internal Number of triplets following 

+4 +4 R781CPDS 4 binary internal Offset to 1/O queuing configuration data section 

+8 +8 R781CPDL 2 binary internal Length of 1/O queuing configuration data section 

+10] +A R781CPDN 2 binary internal Number of 1/O queuing configuration data sections for 


this logical control unit 
Sub-type 1 1/O Queuing Configuration Data Section for the 308x, 908x and 4381 processors: (one per channel path, 
described by triplet R781CPDS) 


+0 +0 R781CPID 1 binary IOCDS Channel path identifier 
+1 +1 R781CPST 1 binary Channel path status 
Bit Meaning When Set 
ICHCONFG 0 ON = channel path installed 
ICHONLIN 1 ON = channel path online 
ERBMFEAR 2 ON = channel path varied 
(module) 3 ON =channel path offline to all devices 
of the LCU 
4 ON = channel path connection to devices of 
the LCU altered by VARY PATH during interval 
5-7 Reserved 
+2 +2 R781CUN 2 binary 1OCDS Number of control units attached 
+4 +4 R781CU1 2 binary 1OCDS First control unit attached 
_ +6 | +6 R781CU2 2 binary IOCDS Second control unit attached 
| | +8 +8 R781CU3 2 binary 1OCDS Third control unit attached 
: +10] +A R781CU4 2 binary 1OCDS Fourth control unit attached 
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Sub-type 1 I/O Queuing Data Section for the 308x, 908x, and 4381 processors: (one per LCU, described by triplet SMF78ASS) 


+0 +0 1 | | Reserved 
+1 +1 R781DST 1 binary Data Status 
Bit Meaning When Set 
CMCTPAA 0 No STCPS data available 


lIOCDS + UCB’'S 1 No UCB found - normal if |OCDS defines more 
devices than SYSGEN 


2 No hardware measurements available 
3-7 Reserved 

+2 +2 R7811CT 2 binary internal Count of invalid samples 

+4 +4 R781ABY 4 binary Number of samples when all channel paths in the logical 
control unit were busy 

+8 +8 R781TIS 4 binary SCHIB Total number of initial selection attempts 

+12 [| +C R781S1S 4 binary SCHIB Total number of successful selection attempts 

+16 | +10 R781CUB 4 binary SCHIB Total number of unsuccessful selection attempts because 
control unit was busy 

+20 | +14 R781DVB 4 binary SCHIB Total number unsuccessful selection attempts because 

device was busy 
+24 | +18 R781QUE 4 binary SCHIB In a 308x/908x processor complex, total number of re- 


quests queued for the logical control unit (accumulated 
at initial selection time) 


+28 1+1C | R7811D2 2 binary | !OCDS Logical contro! unit identifier 


+30 [+1E 2 Reserved 
Sub-type 2 (Virtual Storage) Common Storage Data Section: (described by triplet SMF78DCS) _ a RS 
+0 +0 R782PA 4 binary 4096 Private area address below 16 megabytes 4 
+4 | 44 R782PS 4 binary GDAPVTSZ-4096 | Private area size below 16 megabytes 
+8 +8 R782EPA 4 binary GDAEPVT Private area address above 16 megabytes 
+12 [| +C R782EPS 4 binary GDAEPVTS Private area size above 16 megabytes 
+16 | +10 R782CA 4 binary GDACSA CSA address below 16 megabytes 
+20 | +14 R782CS 4 binary GDACSASZ CSA size below 16 megabytes 
+24 | +18 R782ECA 4 binary GDAECSA CSA address above 16 megabytes 
| +28 | +1C R782ECS 4 binary GDAECSAS CSA size above 16 megabytes 
+32 | +20 R782BA 4 binary Reserved 
+36 | +24 R782BS 4 binary Reserved 
+40 | +28 R782MLA 4 binary CVTMLPAS MLPA address below 16 megabytes 
+44 | +2C R782MLS 4 binary CVTMLPAE+1 MLPA size below 16 megabytes 
—CVTMLPAS 
+48 | +30 R782EMLA 4 binary CVTEMLPS MLPA address above 16 megabytes 
+52 | +34 R782EMLS 4 binary CVTEMLPE+1 MLPA size above 16 megabytes 
—CVTEMLPS 
+56 | +38 R782FLA 4 binary CVTFLPAS FLPA address below 16 megabytes 
1+60 | +3C R782FLS 4 binary CVTFLPAE+1 FLPA size below 16 megabytes 
—CVTFLPAS 


address above 16 megabytes 


FLPA 
FLPA size above 16 megabytes 















PLPA address below 16 megabytes 





PLPA size below 16 megabytes 





wy LA 4 wihlary CV EPFLro 
R782EFLS 4 binary CVTEFLPE+1 
—CVTEFLPS 

R782PLA 4 binary CVTPLPAS 
R782PLS 4 binary CVTPLPAE+1 
7 | ; —CVTPLPAS 
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Sub-type 2 (Virtual Storage) Common Storage Data Section: (described by triplet SMF 78DCS) (continued) 


+80 
+84 


+88 
+92 
+96 
+100 
+104 
+108 


+112 


+116 


+120 


+124 | 


+128 


+132 


+136 


+140 


+144 


+184 


+50 
+54 


+58 
+5C 
+60 
+64 
+68 
+6C 


+70 


+74 


+78 


+7C 


+80 


+84 


+88 


+8C | 


+90 


+B8 


R782ELPA 
R782ELPS 


R782SA 
R782SS 
R782ESA 
R782ESS 
R782NA 
R782NS 


R782ENA 


R782ENS 


R782NL 


R782ENL 


R782LPAI 


R782ELPI 


R782MR 


R782EMR 


R782SQAU 


R782CSAU 


Bb p B QB HF A 


4 


40 


40 


binary 
binary 


binary 
binary 
binary 
binary 
binary 
binary 


binary 


binary 


binary 


| binary 


binary 


binary 


binary 


binary 


See 
Note 1 


See 
Note 1 


CVTEPLPS 


CVTEPLPE+1 
_—CVTEPLPS 


GDASOA 
GDASOASZ 
GDAESOA 
GDAESQAS 
CVTRWNS 


(CVTRWNE+1 
—CVTRWNS)+ 
(16 meg+1 
—CVTRONS) 


16 meg 
(16777216) 


(CVTERWNE+1 


| —CVTERWNS)+ 


(CVTRONE+1 
—16 meg) 


If LPDE present, 
sum of 
LPDEXTLN for 
each CDE chained 
from CVTQLPAQ 


If LPDE present, | 


sum of 
LPDEXTLN for 
each CDE chained 
from CVTOLPAQ 


R782PLS— 
size of LPDEs— 
sum of 
LPDEXTLN 


R782ELPS— 
sum of 
LPDEXTLN 


GDAPVTSZ— 
4096—TCTHWM 
(for RMF address 
space at START 
time) 


GDAEPVTS— 
TCTEHWM (for 
RMF address 
space at START 
time) 


VSMLIST 
SP=SOQA, 
SPACE=FREE 


VSMLIST 
SP=CSA, 
SPACE=ALLOC 


PLPA address above 16 megabytes 
PLPA size above 16 megabytes 


SQA address below 16 megabytes 
SOA size below 16 megabytes 

SOA address above 16 megabytes 
SQA size above 16 megabytes 
Nucleus address below 16 megabytes 


Nucleus size below 16 megabytes 


Nucleus address above 16 megabytes 


Nucleus size above 16 megabytes 


PLPA space redundant with MLPA/FLPA below 16 
megabytes 


PLPA space redundant with MLPA/FLPA above 
16 megabytes 


Intermodule space in PLPA below 16 megabytes 


Intermodule space in PLPA above 16 megabytes 


Maximum possible user region below 16 megabytes 


Maximum possible user region above 16 megabytes 


SQA usage both above and below 16 megabytes 


CSA usage both above and below 16 megabytes 
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Sub-type 2 (Virtual Storage) Common Storage Data Section: (described by triplet SMF78DCS) (continued) 


+224 


+584 


+624 


+664 


+704 


+744 


+784 


+824 


+864 


+E0 


+248 


+270 


+298 


+2C0 


+2E8 


+310 


+338 


+360 


+1064/+428 


R782CSAK 


R782CSAF 


R782CSLF 


R782CSAL 


R782SQAF 


R782SQLF 


R782SQAL 


R782SQEX 


R782227K 


R782228K 


360 See 
(40 Note 1 
bytes 
for 
each 
of 9 
keys) 
40 See 
Note 14 
40 See 
Note 1 
40 See 
Note 1 
40 See 
Note 1 
40 See 
Note 1 
40 See 
Note 1 
40 See 
Note 1 
200 See 
(20 Note 1 
bytes 
for 
each of 
10 keys) 
200 See 
(20 Note 1 
bytes 
for 
each of 
10 keys) 
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VSMLIST 
SP=CSA, 
SPACE=ALLOC 


VSMLIST 
SP=CSA, 


SPACE=UNALLOC 


VSMLIST 
SP=CSA, 


‘| SPACE=UNALLOC 
VSMLIST 


SP=CSA, 
SPACE=ALLOC 
and GDACSA 


+GDACSASZ and 


GDAECSA 
+GDAECSAS 


VSMLIST 
SP=SOA, 
SPACE=FREE 


VSMLIST 
SP=SOA, 
SPACE=FREE 


VSMLIST 
SP=SQOA, 
SPACE=FREE 
and GDASQASZ 
and GDAESOAS 


VSMLIST 
SP=SOA, 
SPACE=FREE 


VSMLIST 
SP=CSA, 
SPACE=ALLOC 


VSMLIST 
SP=CSA, 
SPACE=ALLOC 


2The key data appears in the following order: 0, 1 2, 3,4,5,6, 7, 8-F. 
SThe key data appears in the following order: 0, 1, 2, 3, 4, 5, 6, 7, 8-F, ALL. 





CSA used both above and below 16 megabytes 
by subpool key? 


Free CSA both above and below 16 megabytes 


Largest free block of CSA both above and below 16 
megabytes 


CSA allocated area size both above and below 16 
megabytes 


Free SQA both above and below 16 megabytes 


Largest free block of SQA both above and below 16 
megabytes 


SOA allocated area size both above and below 16 
megabytes 


| SQA expansion into CSA both above and below 16 


megabytes 


CSA subpool 227 (below 16 megabytes) by key? 


CSA subpool 228 (below 16 megabytes) by key? 


























Sub-type 2 (Virtual Storage) Common Storage Data Section: (described by triplet SMF78 DCS) (continued) 


+1264/+4F0 


+1464 |+568 


+1664 |+680 


+1684|+694 


+1704/+6A8 


R782231K 


R782241K 


R782226 


R782239 


R782245 


200 

(20 
bytes 
for 

each of 
10 keys) 


200 

(20 
bytes 
for 

each of 
10 keys) 


20 


20 


20 


See 
Note 1 


See 
Note 1 


See 
Note 1 


See 
Note 1 


See 
Note 1 


VSMLIST 
SP=CSA, 
SPACE=ALLOC 


VSMLIST 
SP=CSA, 
SPACE=ALLOC 


VSMLIST 
SP=SQA, 
SPACE=FREE 


VSMLIST 
SP=SQA, 
SPACE=FREE 
VSMLIST 


SP=SOA, 
SPACE=FREE 


CSA subpool 231 (below 16 megabytes) by key? 


CSA subpool! 241 (below 16 megabytes) by key? 


SQA subpool! 226 (below 16 megabytes) 


SQA subpool! 239 (below 16 megabytes) 


SQA subpool 245 (below 16 megabytes) 


Sub-type 2 (Virtual Storage) Private Area Data Section: (described by triplet SMF78ASS) 


+0 +0 

+8 | +8 

+12 | +C 

+16 {| +10 
+18 1 +12 
+20 | +14 
+28 | +1C 
+36 | +24 
+38 | +26 
+40 | +28 
+44 | +2C 
+48 | +30 
+52 | +34 
+56 | +38 
+60 | +3C 


R782JOBN 


R782RDTM 
R782RDDT 
R782SUBI 


R782SUBN 


R782STEP 
R782PGMN 
R782FLGS 


R782RSV 
R782SAMP 


R782REGR 


R782RGAB 
R782RGAA 
R782GMLB 


R782GMLA 


8 


fp 


- ff fH FA 


4 


EBCDIC 


binary 
packed 
binary 


binary 


EBCDIC 
EBCDIC 
binary 


binary 
binary 


binary 
binary 
binary 


binary 


binary 


ASCBJBNS 
or ASCBJBNI 


JMRENTRY 


JMREDATE 
internal 


internal 


TIOCSTEP 
JSCBPGMN 


internal 


internal 


LDAREGRO 
LDAVVRG 
LDAEVVRG 


LDASTRTA+ 
LDALIMIT 


GDAEPVT+ 
LDAELIM 


Name of job being monitored 


Reader start time 


Reader start date 

Index of first subpool entry in the private area 
subpool section for this job. This field provides the 
first array element for this job‘s private area subpool 
sections. 

Index of last subpool entry for this job. This field 
provides the last array element for this job’s private 
area subpools. 

Name of step active when monitoring began 


Program name of job being monitored 


Flags 

Bit Meaning When Set 

Job active at start of interval 

Job terminated during interval 
GETMAIN limit changed during interval 
Data invalid because RMF terminated 
abnormally while sampling 

4-15 Reserved 


WN - oO 


Reserved 


Number of samples. This field is used to calculate the 
averages in the private area data and private area 
subpool sections. 

Region requested by JCL (in bytes) 


Region below 16 megabytes assigned by exits (in bytes) 
Region above 16 megabytes assigned by exits (in bytes) 


GETMAIN limit below 16 megabytes (in bytes) 


GETMAIN limit above 16 megabytes (in bytes) 


3The key data appears in the following order: 0,1,2,3,4,5,6, 7,8-F, ALL. 
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Offsets 











Ae a 


| Sub-type 2 (Virtual Sis nas) Private Area Data Section: (described by triplet SMF78ASS) (continued) 


| +64 
+68 
+72 


+112 





1+192 


| +232 


+272 | 


14312 | 


| +352 


+152 | 


| | +40 
| +44 


+48 


+70 


+98 


| +C0 


+E8 


+110 | 


+138 | 


+160 


R782URAB 
R782URAA 
R782LSFP 


R782LSFB 


R782LSAL 


R782LSPA 


R782USFP 
R782USEB | 


R782USAL | 


R782USPA 


4 
4 
40 


40 


40 


40 


40 


40 


40 


40 


binary 
binary 


See 


Note 1 


See 
Note 1 


See 


| Note 1 


See 
Note 1 


See 
Note 1 


See 
Note 1 


See 
Note 1 


See 
Note 1 


LDASTRTA 
GDAEPVT 


VSMLIST 
SP=PVT, 
SPACE=UNALLOC 


VSMLIST 
SP=PVT, 
SPACE=UNALLOC 


For below: 
GDAPVT+ 
GDAPVTSZ— 
(LDACRGTP+ 
size of free 

block directly 
above LDACRGTP 
from VSMLIST 
SP=PVT, SPACE= 
UNALLOC) 

For above: 
GDAEPVT 
(LDAERGTP 
block directly 
above LDAERGTP 
from VSMLIST 
SP=PVT, SPACE= 
UNALLOC) 


For below: 
LDAHIAL 
For above: 
LDAEHIAL 


VSMLIST 
SP=PVT, 
SPACE=UNALLOC 


VSMLIST 
SP=PVT, 
SPACE=UNALLOC 


LDACRGTP— 
LDASTRTA 
LDAERGTP— 
GDAEPVT 


LDALOAL 
LDAELOAL 


User region address below 16 megabytes 
User region address above 16 megabytes 


LSQA/SWA/229/230 free pages both above and below 
16 megabytes 


LSQA/SWA/229/230 largest free block both above 
and below 16 megabytes 


LSOQA/SWA/229/230 allocated area size both above 
and below 16 megabytes 


LSOA/SWA/229/230 allocated pages both above 
and below 16 megabytes 


User region free pages both above and below 16 
megabytes 


User region largest free block both above and below 
16 megabytes 


User region allocated area size below 16 megabytes 


User region allocated area size above 16 megabytes 


User region pages allocated below 16 megabytes 
User region pages allocated above 16 megabytes 


|Sub-type 2 (Virtual Storage) Private Area Subpool Section: (described by triplet SMF78SPS) 


{+0 | +0 





R782SPN 


R782SPD 


2 


binary 


VSMLIST 
SP=PVT, 
SP=LSOA, 
SPACE=ALLOC 


VSMLIST 
SP=PVT, 


SP=LSOA, 
SPACE=ALLOC 


Subpoo!l number? 


Reserved 


Subpoo!l data 


4 Each private area data section occurs one after the dther, All Private area subpool sections follow all 
private area data sections. To relate a subpool to a E18: see the R782SUBI and R782SUBN fields in 


the private area data section. 
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Note 1: 
The format of these bytes follows. For fields containing data from below 16 megabytes, use only the first 20 bytes. For fields 
containing data from both below and above 16 megabytes, use all 40 bytes. 


a 


Data collected below 16 megabytes: 





























VSDBMIN 
VSDBNTME 
VSDBMAX 
VSDBXTME 
VSDBTOTL 


binary Minimum value for below 16 megabytes 








binary Time stamp for minimum* 





binary Maximum value for below 16 megabytes 









binary Time stamp for maximum* 





single precision 
floating point 


Total for all samples below 16 megabytes (used to 
calculate average). See SMF78SAM to calculate 
averages for common storage data section fields, and 
R782SAMP to calculate averages for private area data 
and private subpool section fields. 


Data collected above 16 megabytes: 


VSDAMIN binary Minimum value for above 16 megabytes 

VSDANTME binary Time stamp for minimum* 

VSDAMAX binary Maximum value for above 16 megabytes 

VSDAXTME binary Time stamp for maximum* 

VSDATOTL single precision Total for all samples above 16 megabytes (used to 
floating point calculate average). 


100 Global Section described by SMF 780DS 


| +0 +0 R783GFLG 1 binary internal Global |OQO Status: 
Bit Meaning 
0 ON=data is invalid due to failure of the channel 


measurement facility 
1 ON=DIAGNOSE interface failure 


+1 +1 R783GNTR 
+3 | R783GIDS 


2 binary internal Number of descriptor triplets 
4 
+7 +7 R783GIDL 2 binary internal Length of [OP initiative queue data section 
2 
4 


binary internal Offset to [OP initiative queue data section 


+9 +9 R783GIDN 
+11 +B R783GSAM 


binary internal Number of IOP initiative queue data sections 


binary CPMTSAMP_ | CPMT sample count 


Sub-type 3 IOP Initiative Queue Control Section for the 3090 processor: (described by triplet SM F78QDS). 
+0 +0 R783GFLG 1 binary internal 10Q global flags 


Bit Meaning 
0 ON = invalid data because channel measurement 
facility failed 
1 ON = DIAGNOSE interface failed 
2-7 Reserved 
+1 +4 Reserved 


+2 +2 R783GNTR 
+4 +4 R783GIDS 
+8 +8 R783GIDL 
+10 | +A R783GIDN 
+12 | +C R783GSAM 


binary internal Number of triplets following 

binary internal Offset to |OP initiative queue data section 
binary internal Length of IOP initiative queue data section 
binary internal Number of !OP initiative queue data sections 


binary CMPTSAMP CMPT sample count 


BNO NYO FS NV 





*The format of a time stamp is the high order word of the TOD clock adjusted to local time by adding CVTTZ. 
The time stamp is in units of 1.048576 seconds. 
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Sub-type 3 10P Initiative Queue Data Section for the 3090 processor: (one per initiative queue described by triplet R783GIDS) 


+0 
+2 


+3 
+4 


+8 


+0 
+2 


+3 
+4 


+8 


R783101D 
R783IFLG 


R7831QSM 


R7831QCT 


zs 


1 


4 


4 


EBCDIC 


binary 


binary 


binary 


HSA(DIAGNOSE) 


DIAGNOSE 


HSA 


HSA 


1OP initiative queue identifier 
IOP Flags | 


Bit Meaning 
0 ON = IOP is installed 
1-7 Reserved 


Reserved 


Sum of the number of requests enqueued on the [OP 
initiative queue. This value represents the total length 
of the queue and is used to calculate the average queue 
length for the IOP. 


Number of IOP queue entries. This value represents the 
current queue length or the number of times an element 
was added to the queue. It is used in calculating the 
average queue length for the IOP. 


Sub-type 3 1/O Queuing Control Section for the 3090 processor: (one per LCU, described by triplet SMF78DCS) 


Sub-type 3 1/O Queuing Configuration Data Section for the 3090 processor: (one per channel path, described by triplet R783CPDS) 


+0 | +40 R7831D1 
+2 | 42 R783NTR 
+4 | +4 R783CPDS 
+8 | +8 R783CPDL 
+10| +A | R783CPDN 
+0 | +0 R783CPID 
+1 | 41 R783CPST 
+2 | +42 R783CUN 
+4 | +4 R783CU1 
+6 | +46 R783CU2 
+8 | +8 R783CU3 

1+10] +A | R783CU4 
+12 | +C R783CUB 

)+16| +10 | R783PT 
+20| +14 | R783PB 


2 
2 
4 
2 
2 


1 
1 


Bh BP BP MO NM NM ND NO 


binary 
binary 
binary 
binary 


binary 


binary 


binary 


binary 

EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 


| binary 


binary 


binary 


1OCDS 
internal 
internal 
internal 


internal 


1OCDS 


ICHCONFG 
ICHONLIN 


ERBMFEAR 


lOCDS 
1OCDS 
1\OCDS 
lOCDS 
lOCDS 
HSA 

HSA 
CPMTBUSY 


Logical control unit identifier 

Number of triplets following 

Offset to |/O queuing configuration data section 
Length of 1/O queuing configuration data section 


Number of !/O queuing configuration data sections 


Channel path identifier 
Channel path status 


Bit Meaning When Set 


0 ON = channel path installed 

1 ON = channel path online 

2 ON = channel path varied 

3 ON = channel path offline to all devices of the LCU 

4 ON = channel path connection to all devices of the 
LCU altered by VARY PATH command during 
interval 

5 ON = measured channel path data invalid 


Number of control units attached 

First control unit attached 

Second control unit attached 

Third control unit attached 

Fourth control unit attached 

Number of times control unit was busy 
Number of times channel path was taken 


Number of samples when this channel path (CHPID) 
was busy. Used with CMPT sample count, R783GSAM. 


Sub-type 3 1/O Queuing Data Section for the 3090 processor: (one per LCU, described by triplet SMF78ASS) 


+0 
+2 


+3 
+4 
+8 


6-206 


+0 
+2 


+3 
+4 
+8 


R7831D2 
R783DST 


R7830QSM 
R783QCT 


2 
1 


binary 


binary 


binary 


binary 


System Management Facilities (SMF) 


lOCDS 
ENF events 


HSA 
HSA 


Logical control unit identifier 
Data Status: 


Bit Meaning 
Q ON = No hardware measurements available 


1-7 Reserved 

Reserved 

Sum of total queue length of CU-HDR 
Number of entries on CU-HDR 





























Record Type 79 (4F) — Monitor II Activity 





Record type 79 is written during a Monitor IJ background session when feedback is 
requested in the form of SMF records. It is written by ERBMFBPC at each measure- 
ment interval and when the session is terminated. It contains a section that is 
identical for all Monitor II reports and a sub-type section that is unique for each 
report. The length of the record is 112 bytes plus 92 bytes for the Monitor II sec- 
tion. The sub-types are: 


e sub-type 1 — contains information that describes address space state data and 
address space state data by jobname; for each address space identifier included, 
the length is 52 bytes. 


e@ sub-type 2 — contains information that describes address space resource data 
and address space resource data by jobname; for each address space identifier 
_ included, the length is 112 bytes. 


@ sub-type 3 — contains information that describes real storage/processor/SRM 
activity; the length is 38 bytes. 


e sub-type 4 — contains information that describes paging activity; the length is 
68 bytes 


e sub-type 5 — contains information that describes address space SRM data and 
address space SRM data by jobname; the length is 60 bytes for each address 
space identifier included. 


e sub-type 6 — contains information that describes reserve data. The length is 84 


bytes 
Ha e sub-type 7 — contains information that describes enqueue contention data. The 
| length is 89 bytes. 


e sub-type 8 — contains information that describes transaction activity; the length 
is 51 bytes for each performance group period included. 


@ sub-type 9 — contains information that describes device activity. The length 
depends on the number of devices. 


@ sub-type 10 — contains information that describes domain activity. The length 
is 52 bytes. 


@ sub-type 11 — contains information that describes paging and swap dataset 
activity. The length is variable. 


@ sub-type 12 — contains information that describes channel path activity. The 
length is variable. 


@ sub-type 13 — contains information that describes I/O queuing activity by 
logical control unit for the 308x, 908x, and 4381 processors. The length is 
variable. 


® sub-type 14 — contains information that describes I/O queuing activity by logical 
control unit for 3090 processors. The length is variable. 


For a description of the mapping macro, see record type 70. 


The format is: 





Chapter 6. SMF Records 6-207 


SMF79LEN 2 binary internal Record length 
2 2 SMF79SEG 2 binary internal Segment descriptor 
4 4 SMG79FLG 1 binary SMFWTM service System indicator 
FOUEINE Meaning When Set 
0 Subsystem ID following standard header, relocat- 
able record format 
1 Subtype utilized 
2-4 Reserved 
5 MVS/XA 
VS2 
SMF79RTY binary internal Record type: 79 (X‘4F‘) 
6 6 SMF79TME 4 binary SMFWTM service Time, in hundredths, of a second when record was moved 
routine to SMF buffer 
10 A SMF 79DTE 4 packed SMFWTM service Data Record was moved to SMF buffer, in the form 
routine OOyydddF where F is the sign 
14 E SMF79SID 4 EBCDIC | SMCASID System identification (taken from SID parameter) 
18 | 12 SMF79SSI 4 EBCDIC | _ internal Sub-system identification (‘RMF’) 
22 16 SMF79STY 2 binary internal Record subtype 
24 18 SMF79TRN 2 binary internal Number of triplets in this record ; 
26 1A 2 binary Reserved 
28 | 1C SMF79PRS 4 binary internal Offset to RMF product section 
32 20 SMF79PRL - 2 | binary internal Length of RMF product section 
34 22 SMF79PRN 2 binary internal Number of RMF product sections 
36 24 SMF 79MCS 4 binary internal Offset to Monitor I! control section 
40 28 SMF79MCL 2 binary internal Length of Monitor I| control section 
42 2A SMF 79MCN 2 binary internal Number of Monitor t! control sections 
44 2C SMF 79ASS 4 binary internal Offset to data section 
48 30 SMF79ASL 2 binary internal Length of data section 
50 32 SMF79ASN_ 2 binary internal Number of data sections 





(The following 6 fields are not present for all subtypes. ) 















































52 34 SMF79DCS 4 binary internal Offset to data control section or configuration section 

56 | 38 SMF 79DCL 2 binary internal Length of data control section or configuration section 

58 3A SMF 79DCN 2 binary internal Number of data control section or configuration section 

60 | 3c | smF79ass 4 | binary | internal Offset to 10Q global section 

64 40 SMF 79Q0SL 2 binary internal Length of 10Q global section 

| 66 | 42 SMF79QSN 2 binary internal Number of !OQ global sections 
: RMF Product Section: 
0 0 SMF 79MFV 2 EBCDIC/| internal RMF version number. For more information on the 
packed version number, see the RMF version number description 

in record type 70 and the Resource Measurement Facility 
(RMF) Reference and User’s Guide. 

2 2 SMF79PRD EBCDIC | internal Product Name 

10 A SMF79IST 4 packed internal Snap shot time for Monitor II report | 

14 E SMF 79DAT 4 packed internal Date RMF Monitor 1 measurement interval started, in the 





| form OOyydddF, where F is the sign 


TA triplet is a set of offset/length/number values that defines a section of the record. 
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| Offsets | Name | Length | Format | Source | scription 


RMF Product Section (continued): 


18 


22 
24 
28 
30 


32 


36 


40 


48 


49 
+50 


12 


16 
18 
1C 
1E 


20 


24 


| 28 


30 


31 
+32 


SMF 79INT 


SMF79MFL 
SMF 79SAM 
SMF79RV2 
SMF 79FLA 


SMF 79CNV 
SMF 79ISS 


SMF79RLS 


SMF79CYC 


SMF79MVS 


SMF79IML 


SMF 79PRF 


Monitor I! Control Section: 


+0 


+4 


| 45 
+6 
+08 
+10 


+12 | 


+20 
+22 
+54 
+56 
+88 


| +0 


+4 


Pade 


+6 
+8 
+A 
+C 
+14 
+16 
+36 
+38 
+58 


R79GTOD 


R79LF2 


R79RV1 
R79SES 
R79RSV 
R79USER 
R79RID 
R79CTXTL 
R79CTEXT 
R79DTXTL 
R79DTEXT 
R79IST 


4 


NN nO Ff DN 


packed 


binary 
binary 
binary 
binary 


EBCDIC 


packed 


EBCDIC 


binary 


binary 


packed 


binary 


binary 
EBCDIC 


| binary 


EBCDIC 
binary 
EBCDIC 
binary 
EBCDIC 
packed 





internal 


internal 


internal 


internal 


CVTRELNO 


internal 


CVTPRODN 


CSDIOML 


internal 


TIME macro 


internal 


MISBNAME 


PCTRID 
PCTOPRD 
PCTOTEXT 
PCTDEDOL 
PCTDRO 
MFSBITOD 





Duration of RMF Monitor 1 measurement interval, in the 
form mmsstttF where F is the sign. (The end of the mea- 
surement interval is the sum of the recorded start time 
and this field.) 


Record Maintenance Indicator 
Number of RMF samples 
Reserved 

Flags 


Bit Meaning When Set 

0 Unused-internally by RMF post processor 
1 Samples have been skipped. 

2-15 Reserved 


Operating system release number and level, in the form | 
nnli 


Sampling cycle length in the form OOOttttF, where F is 
the sign (taken from CYCLE option). The range of 
values is 0.050 to 9.999 seconds. 


MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


Indicates the type of processor complex on which data 
measurements were taken 


Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 


X‘80’ indicates system has extended storage 


Reserved 


Time when call to data gatherer was issued, in the form 
hhmmsstF, where F is the sign 


Flags 
X‘80’ indicates that there are not enough relocate data 
sections to complete data gathering 


Reserved 

RMF session identifier 

Reserved 

Reserved user field 

Measurement name 

Length of command text 

Text of command 

Length of data reporter default text 


Default data reporter text 


Monitor | internal start time 
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co™~ 


Sub-type 1 (ASD and ASDJ) Data Section: 





+0 | +0 | R791ASID 2  |binary |ASCBASID | Address space identifier 
+2 +2 R791JBN 8 EBCDIC/ASCBJBNi pointer | Name of job 
or ASCBJBNS pointe 
+10 +A R791DMN 2 binary [GCUCBDMN Domain number 
+12 +C R791NPG 2 binary |OUCBNPG Performance group 
+14 | +6 R791PGP 2 binary }((OUCBPGP - Performance group period 
(LENGTH (WPGD) - 
LENGTH (WPGR))) 
/LENGTH(WPGP)) +1 
+16 +10 | R791TTOD 4 Reserved 
+20 +14 | R791CL 2 EBCDIC |Set to IN when al! Current location 
a Ine cmos sare Contents Meaning 
| IN In storage 
|OUCBPVL PR Privileged 
OUCBNSW NS Non-swappab le 
OUCBOFF, WM Wait queue/MSO 
OUCBMWT 
|OUCBOFF, | WT Wait queue/terminal wait 
OUCBTRM 
OUCBOFF, WL Wait queue/long wait 
OUCBLWT | 
|OUCBOFF wo Wait queue/reasons other 
than WM, WL, or WT 
OUCBOUT, | DL Out queue/delayed A 
OUCBDLYB 
OUCBLSW LO Logically swapped out | ae 
}OUCBOUT OT Swapped out and ready 
OUCBGOO >> Transitioning out 
OUCBGO! << Transitioning in 
| +22 +16 R791TAS 2 binary Type of user 
Contents Meaning 
ASCBJBNI oO Batch 
OUCBSTT 1 Started task 
OUCBMNT 2 Mount task 
OUCBLOG 3 TSO 
+24 | +18 | R791SRC 2 EBCDIC |OUCBSEC = 1 Reason for last swap-out 
through 14 Contents Meaning 
Tl Terminal input 
TO Terminal output 
LW Long wait 
j XS Auxiliary storage shortage 
RS Real storage shortage 
DW Detected wait 
RQ Request swap 
NQ CAP enqueue 
EX CAP exchange 
US CAP ufi-swap 
TS Transition 
00 Unknown 
| +26 | +1A | R791DP | 2 binary |ASCBDP Dispatch priority 
+28 | +1C | R791SEQN 2 binary Reserved 


(Continued) 
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Sub-type 1 (ASD and ASDJ) Data Section: (continued) 


+30 | +1E R791FMCT 2 binary 
+32 | +20 R79 1WSS 2 binary 
+34 | +22 R79 1SWC 2 binary 
+36 | +24 R79 1SWMR 2 binary 
+38 | +26 | R791SCRV 2 =| binary 
| +40 | +28 R791SIOC 2 binary 
+42 142A] R791WMS binary 
+46 | +2E R79 1TCPU 4 binary 
+50 | +32 R791SSRV 2 binary 
+52 {| +34 R791ES 2 binary 
+54 | +36 R791ESSL 4 binary 
+56 | +38 ~R791TWSS 2 binary 
Sub-type 2 (ARD and ARDJ) Data Section: 
+0 +0 R792ASID 2 binary 
+2 +2 R792JBN 8 EBCDIC 
+10 | +A R792DMN 2 binary 
+12 {| +C R792NPG 2 binary 
+14 | +E R792CL 2 EBCDIC 
+16 | +10 R792TAS 2 binary 
+18 | +12 R792TRC 2 binary 
+20 | +14 R792TTOD 4 binary 
+24 | +18 R792PRFX | binary 
+28 | +1C R792ARS 2 binary 
+30 | +1E | R792SVAR 4 binary 
+34 | +22 R792TCPU 4 binary 
+38 | +26 | R792PSS 


ASCBFMCT 
OUCBWSS 
OUCBSWC 


OUCBWMR/256 


OUCBCRV* 


RMPTCPU/256 


OUCBIRV* 


RMPTIOC/256 


OUCBWMS 


ASCBEJST + 
ASCBSRBT 


OUCBSBRV 


RAXECST 


| OUCBTWSS 


ASCBASID 
internal 
OUCBOMN 
OUCBNPG 
OUCBOFL 


OUCB4FL 


IOUXBTRC 


RMCTTOD, 
OQUCBTMO 
IARXCNTF 


OUCBPSE, 
R792E JST 


‘R792TSRM, 
R792RTM 


ASCBEJST 


{OUCBPSS 


~ SRM processor recommendation value 






‘Total TCB time for step, in milliseconds 


Step product of frame, in milliseconds 


Number of real storage frames 
Working set at last swap-in 
Transaction swap count 


SRM work load recommendation value 





SRM 1/O recommendation value 


SRM service for the current transaction since the last swap-in 





CPU time (TCB + SRB) for current job step, in milliseconds 


SRM storage recommendation value 
Number of extended storage frames used by the job. 


Reserved 
SRM target working set size 







Address space identifier 





Name of job 









Domain number 






Performance group 


Current location 


















Contents Meaning 

IN In storage 

LO Logically swapped out 
OT Swapped out and ready 
NS Non-swappable 

WM Wait queue/MSO 

WL Wait queue/long wait 
WwO Wait queue/reasons other than WM, WL, or WT 
DL Out queue/delayed 

WT Wait queue/terminal wait 
PR Privileged 

>> Transitioning out 

<< Transitioning in 





Type of user 







Contents Meaning 

0 Batch 

1 Started task 
2 Mount task 






TSO 


Transaction count 






- Transaction elapsed time, in milliseconds 







Number of private fixed frames 


Average number of real frames for step 







SRM service absorption rate for step 
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Sub-type 2 (ARD and ARDJ) Data Section: (continued) 


+38 |+26 | R792PSS1 ] 4 binary OUCBPSS1 
+42 14+2A | R792PSS2 4 binary OUCBPSS2 — 
+46 |+2E | R792EJST 4 binary ASCBEUJST + 
ASCBSRBT 
+50 |+32 | R792TSRM 4 binary OUXBJBS + 
OUXBTARS + 
OUCBWMS 
+54 1+36 | R79RTM 4 binary OUXBJBR + 
OUXBTRR + 
RMCTTOD - 
OUCBTMS 
+58 1+3A | R792EXCP 2 binary ASCBIOSM + 
OUCBIOSM 
+60 |+3C | R792CMNI 4 binary OUXBCAPI 
+64 |+40 | R792PNV 4 binary OUXBPIN + 
OUXBPOUT 
+68 [+44 | R792PVIO 4 binary OUXBVAMI + 
OUXBVAMO 
+72 |+48 | R792FXBL 4 binary IARXCNTF 
+76 |+4C | R792PSWP 4 binary OUXBPSIN + 
OUXBSPOT 
+80 1+50 | R792LPAI 4 binary OUXBLPAI 
+84 1+54 | R792CSAI 4 binary OUXBCAPI - 
OUXBLPAI 
+88 |+58 | R792LSOA 4 binary IARXCNTF 
+92 |+5C | R792NLOF 4 binary IARXCNTF 
+96 14+5E | R792TDEV 4 binary |’ ASCBDCTI 
+100 | +64 R792TWSS 2 binary OUCBTWSS 
+102|+66 | R792PIN 4 binary OUXBPIN 
+1061+6A | R792TRTM 4 | binary OUXBTRR + 
(RMCTTOD — 
OUCBTMS) 
+110 |+6E | R792FLG 2 binary ASCBXMEC 
+112 | +70 1 
Sub-type 3 (SRCS) Data Section: | 
+0 +0 R793AFC 2 binary RCEAFC 
+2 |42 R793CRI 2 binary MCVSTCAI 
+4 144 R793SOA 2 binary [ARXCRMF 
+6 146 R793CMNF 2 binary RCECOMAL 
+8 «+148 R793CMFF 2 binary | RCECOMEX 
+10 |+A R793PRFX 2 binary RCETOTFX - 
RCECOMEX + 
|ARXCRMF* 
+12 |4C R793CPUU . 2 binary CCVUTICP 
+14 | +E R793D0 2 binary, ASCB dispatching 


queue pointed to 
by CVTASCBH ; 


*RSM service routine 
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F lags 


High order word 
Low order word 


Total processor time (TCB +SRB), in milliseconds 


Total SRM service for job or session 


Resident time for step, in milliseconds 


EXCP count for step 


Number of common pages for current transaction 


Number of non-V10O pages for current transaction 
Number of VIO pages for current transaction 


Number of fixed frames below 16-megabytes 


Number of pages swapped in and out for current 
transaction 


Number of LPA pages paged in for current transaction 


Number of CSA pages paged in for current transaction 


Number of LSQA fixed frames o Be. 
Number of non-LSQA fixed frames 

Total device connect time in milliseconds 

SRM target working set size for this job. 


Page in count 


Transaction residency time 


Bit Meaning When Set 

0 On — — indicates cross memory address space 
1-15 Reserved 

Reserved 


Number of available frames 

Highest UIC count 

Number of SQA frames 

Number of frames allocated to the common area 
Number of common (LPA + CSA) fixed frames 


Number of private fixed frames (LSOQA + non-LSQA) 





Processor utilization (O - 101) 


Length of ASCB ready queue 




















| Offssts | Name | Length | Format | Source [| eseription 


| Sub-type 3 (SCRS) Data Section: (continued) 


+16 | +10 | R793INC 2 binary OUCB queue 
pointed to by 
RMCTIOE 


+18 | +12 R7930UTU 2 binary OUCB queue 
pointed to by 






Number of address spaces in storage (SRM in queue) 







Number of address spaces out of storage (SRM out 
queue) 






















































































































RMCTOTQOE 
+20 | +14 R793LCU 2 binary Reserved 
+22 | +16 R793ASMQ 2 binary RCVASMQA SRM measure of ASM queue length 
+24 | +18 R793LPAF 2 binary IARXCRMF* Number of LPA pageable frames 
+26 | +1A R793CSAF 2 binary IARXCRMF* Number of CSA pageable frames 
RCECOMAL 
+28 | +1C R793LPFX 2 binary IARXCRMF* Number of LPA fixed frames 
+30 | +1E R793CSF X 2 binary IARXCRMF* Number of CSA fixed frames 
RCECOMFX 
+32 +20 R793LSQA 2 binary IARXCRMF* Number of LSQA frames 
+34 | +22 R793NLOF 2 binary RCETOTFX Number of private non-LSQA fixed frames 
IARXCRMF* 
RCECOMF X 
IARXCRMF* 
+36 | +24 R793LOUT 2 binary OUCBLSW Number of address spaces logically swapped out 
Sub-type 4 (SPAG) Data Section: 
+0 +0 R794CMNI 4 binary RCECOMPI System common (LPA + CSA) pages in 
7 +4 +4 R794CMNO 4 binary RCECOMPO System common (CSA) pages out 
( | +8 | +8 R794CMNR 4 Reserved 
+12 | +C R794SWPO 4 binary SWCTPSDA+ Number of swap-outs 
SWCTLSES+ 
SWCTLSAX+ 
SWCTPSDE+ 
SWCTPSM 
+16 | +10 R794PSPI binary RCESWPPI Number of pages swapped in 
+20 | +14 R794PSPO binary RCESWPPO Number of pages swapped out 
+24 | +18 R794PRVI binary RCETOTPI + Number of private pages (V!IO + non-VIO) swapped in 
RCEVIOPI - 
RCECOMPI 
+28 | +1C R794PRVO 4 binary RCETOTPO + Number of private pages (VIO + non-VIO) swapped out 
RCEVIOPO ~ 
RCECOMPO 
+32 | +20 R794PRVR 4 . Reserved 
+36 | +24 R794VI0 4 binary RCEVIOPI! + Number of VIO pages (in + out) 
RCEVIOPO 
+40 | +28 R794AFC 2 binary ‘“RCEAFC Number of available frames 
+42 | +2A R794CRI 2 binary MCVSTCRI Highest UIC count 
|+44 | +2C | R794ACRI 2 Reserved 
+46 | +2E R794RV1 2 Reserved 
+48 | +30 R794LPAI 4 binary RCELPAPI System LPA pages in 
+52 | +34 | R794CSAI 4 binary RCECOMPI - System CSA pages out 
RCELPAPI 
+56 | +38 | R794LPAR 4 Reserved 






+60 | +3C R794CSAR 4 
+64 | +40 R794TWSS 


*RSM service routine 


Reserved 






MCVTWSS Target working set size for the common area 
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Sub-type 4 (SPAG) Data Section: (continued) 


R794ERTE 
R794EVAL 


R794ESSL 
R794MRTE 


R794MAGE 


binary 
binary 
binary 
binary 


binary 


binary 





Sub-type 5 (ASRM and ASRM4J) Data Section: 


+0 
+2 
+10 
+12 
+14 
+16 


+20 


+22 


+24 


+28 
+30 
+32 








+0 


+2 
+A 
+C 
+E 
+10 


+14 


+16 


+13. 


+1C 
+1E 
+20 


+24 


R795ASID 
R795JBN 
R795DMN 
R795NPG 
R795PGP 
R795TTOD 


R795CL 


R795TAS 


R795T ROD 


R795TCNT 
R795SWC 
R795CPUS 


R795MSOS 


&BNN NY W N 


& NO WN 


binary 
EBCDIC 


binary 


binary 
binary 
binary 


EBCDIC 


binary 


binary 


binary 
binary 


binary 
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RCEESWRT 
.-RCEAEC 


RCENWSF 
+RCEWSDNE 


MCVMGAGE 


ASCBASID 
internal 
OUCBDMN 
OUCBNPG 
OUCBPGP 


RMCTTOD - 
OUCBTMO 


Set to IN when ail 
other indicators are 
off 


OUCBOUT 
OUCBNSW 
OUCBMVT 
OUCBLWT 
OUCBTRM 
OUCBOFF 
OUCBPVL 
OUCBGOO 
OUCBGOI 


ASCBJBNI 
OUCBSTT 
OUCBMNT 
OUCBLOG 


OUXBTRR + 
(RMCTTOD - 
OUCBTMs) 


OUXBTRC 
OUCBSWC 


OucscPU 


OUCBMSO 








Unused 
Number of pages sent to extended storage 
Number of extended storage frames not in use 


Reserved 


Number of pages migrated from extended storage to 
auxiliary storage 


Migration age 





Address space identifier 
Name of job 

Domain number 
Performance group 
Performance group period 


Real time into transaction 


Current location 


Contents Meaning 

IN In storage 

LO Logically swapped out 
OT Swapped out and ready 
NS Non-swappable 

WM Wait queue/MSO 

WL Wait queue/long wait 
WT Wait queue/terminal wait 
wo .Wait queue/other wait 
PR Privileged 

eg Transitioning out 

<< Transitioning in 

Type of user 

Contents Meaning 

0 Batch 

1 Started task 

2 Mount task 

3 TSO 


Transaction resident time 


Transaction count 
Transaction swap count 


Total processor service for transaction (zeroes when ASID 
is out of storage) 


Total MSO service for transaction (zeroes when ASID is 
out of storage) 


Total 1OC service for transaction (zeroes when ASID is 
out of storage) 
- Total service fo 


storage) 





(continued } 





& 
ae, 











Sub-type (ASRM and ASRM\J) Data Section: (continued) 
+48 |+30 | R795TOTL 4 binary OUXBJBS + 
OUXBTRS + 
OUCBWMS 
+52 | +34 | R795TOT 4 binary OUCBWMS 
+56 | +38 | R795SRBS 4 binary OUCBSRB 
R796ASID Binary RIBEASID 
R796MAJ EBCDIC | RIBONAME 
R796MIN EBCDIC | RIBRNAME 
R796JBN EBCDIC | RIBEJBNM 
R796VOLS EBCDIC | UCBVOLI 
R796UCB EBCDIC | UCBNAME 
R796REQ EBCDIC | RIBESTAT + 
RIBETYPE 
R796MINL Binary RIBRNMLN 
R796F LG Binary internal 
‘R796SID. EBCDIC | RIBESYSN 
Sub-type 7 (SENQ) Data Section: 
+0 | +0 R797MAS 8 EBCDIC | RIBONAME 
+8 | +8 R797MIN 44 EBCDIC | RIBRNAME 
+52 | +34 R797FLG 1 Binary internal 
+53 | +35 | R797MINL 4 Binary RIBRNMLN 
+57 | +39 | R7970WN 2 Binary RIBNTO 
+59 | +3B | R797EXCWi 2 Binary RIBNTWE 
+61 |+3D | R797SHRW| 2 Binary RIBNTWS 
+63 | +3F | R797REQ 2 EBCDIC | RIBETYPE + 
RIBEJBNM 
+65 | +41 | R797JBN 8 EBCDIC | RIBEASID 
+73 |. +49 | R797ASID 2 | Binary | RIBEASID 
+75 | +48 | R797SCOP 4 EBCDIC | RIBSCOPE 
+79 | +4F | R797RES 2 EBCDIC 
+81 | 451 | R797SID 8 EBCDIC | RIBESYSN 
3 











[eae 






Total service for job or TSO session (zeroes when ASID 
is out of storage) 






Total service for transaction since last swap-in 





Total SRB service for transaction (zeros when ASID is 
out of storage) 








Address space ID of the job that issued the RESERVE 
Major name of the resource 






Minor name of the resource 
Name of the job that issued the RESERVE 


Volume serial of the volume against which the 
RESERVE was issued 


The device against which the RESERVE was issued 









Type and status of request for the resource 









Length of the minor name field (used for reporting) 
Reserve flag byte 

Bit Meaning When Set 

0 ON=device reserved by this CPU 

2 ON=minor name truncated 

3-7 Reserved 


System identifier of the job that issued the RESERVE 








Major name of resource 

Minor name of resource 

Data type flags 

Bit Meaning When Set 

0 ON=detail data 

OFF=summary data 

ON=major name specified 

ON=minor name specified 

ON=minor name truncated 

Global resource 

Data is for all resources held by a specified system 
in a global resource serialization complex 

Data is for all resources held exclusively by a 
specified system in a global resource serialization 
complex 

7 Reserved 


aOPwWND — 


0) 


Length of the minor name field (used for reporting) 
Count of requestors that own the resource 


Count of requestors waiting for exclusive use of a resource 
Count of requestors waiting for shared use of a resource 
Type and status of resuest for a resource 
(‘SO’,’SW’,’EO’,or’ EW’) 
Name of the job that issued the ENO 
Address space ID of the job that issued the ENO 

_ Scope of the resource (‘SYS’,/SYSS’,or ‘STEP’) 
Reserved 
System identifier of the job that issued the ENQ | 


Reserved 
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[offs [ Name] toneth [Format | Source 


Sub-type 8 (TRX) Data Section: 


+0 
+2 
+4 
+6 
+8 
+12 


+16 


+20 


+30 
+40 
+50 


+0 
+2 
+4 
+6 
+8 
+C 


+10 


+24 


+2E 
+28 
+32 


R798!CSI 
R798IPSI 
R798PGN 
R798PGP 
R798SYS 
R798TT X 


R798TTM 


R798CLS 


R798USR 
R798NAM 
R798FL1 


& PB NM MY NY NY 


10 


10 
10 
1 


EBCDIC 
EBCDIC 
binary 
binary 
EBCDIC 


binary 


binary 


EBCDIC 


EBCDIC 
EBCDIC 


binary 


Sub-type 9 Device Data Section: (one per device) 


+0 
+2 
+4 
+5 


| 46 


+12 
+16 
+20 


+24 
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R799NUM 
R799LCU 
R799RVO 
R799CNF 


R799SER 


R799TYP 
R799NUX 
R799SSC 


R799MEC 


re wee eR me 


A/IYICNN 


R799PEN 


2 
2 
1 


& ff HL 


packed 
binary 
binary 


binary 


EBCDIC 


binary 
binary 


binary 


binary 


binary 


binary 
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RMCTICST 
WAMTIPS 
WAMT 
WAMT 
ICSM 
WAMPTRN 


WAMPTET 


ICSM 


ICSM 
ICSM 
WAMPRPT 


EDDDNUM 
EDDDLCUN 


EDDDNQUL 
EDDDNLCD 
EDDDNCMB 


EDDDMXPB 
EDDDCCHG 


EDDDALIV 
UCBVOLI 


internal 
EDDDNUMX 


CMBSSCHC - 
EDDDLSSC + 
EDDDASSC 


CMBSAMPC - 
EDDDLMEC + 
EDDDAMEC 
CMBCONNT - 
EDDDBCNN 
CMBPENDT - 


EDDDBPEN 





Description 





identifier of IEAICSxx parmlib member 

Identifier of IEAIPSxx parmlib member 

Performance group number 

Performance group period 

Subsystem name associated with the performance group 


Number of ended transactions for the performance 
group period 


Elapsed time (in 1024-microsecond units) for all ended 
transactions in the performance group period 


Transaction class name associated with the performance 
group 

User identifier associated with the performance group 
Transaction name associated with the performance group 
Data type flags 


Bit Meaning When Set 

0 ON - performance group is a report performance 
group 
OFF - performance group is a control performance 
group 
On-account information used 
Reserved 


Device number 

Logical control unit number X‘00’ to X’FF’ 
Reserved 

Device flags 


Bit | Meaning When Set 

0 ON = 10S queue-length invalid 

1 ON = NO logical control unit information 
2 ON = CMB data invalid 

3-4 Reserved 


5 ON = device is multiple exposure device: this is 
base exposure 

6 ON = device was reconfigured or DDR activity was 
detected during Monitor | interval 

7 ON = device is currently online 


Volume serial number of the volume mounted on this 
device 


Device type 
Number of exposures if multiple exposure device 


Start subchannel (SSCH) count 


Measurement event count - number of SSCH instructions 
for which connect, pending, and active times were stored 


Device connect time 





Function pending time 

















Sub-type 9 Device Data Section: (one per device) (continued) 





+36 | +24. R799ATV 4 binary CMBACTVT - Function active time 
EDDDBATV 
+40 }] +28 R799DIS 4 binary CMBACTVT - Device disconnect time 
(CMBPENDT + 
CMBCONNT) 
+44 | +2C R799QUE 4 binary EDDDNENQ Number of requests queued in 1OS for this device 
+48 | +30 R799UTL 4 binary EDDDBUSY Number of samples when the device was reserved but an 
SSCH had not been issued to the device 
+52 | +34 R799RSV 4 binary EDDDRESV Number of samples taken during the measurement inter- 
val that indicated that the device was reserved 
+56 | +38 R799DSO 4 binary EDDDDSOP Total number of data sets open on the device 
+60 | +3C R799ALC 4 binary EDDDALOC Number of samples taken during the measurement inter- 
val that indicated that the device was allocated. 
+64 | +40 R799DVB I 4 binary SCHMDTDB Device busy delay time (for the 3090 processor only) 
+68 | +44 R799CUB 4 binary SCHMDTCB Control unit busy delay time (for the 3090 processor only) 
| +72 | +48 R799 ICT 2 binary I\OCSTSQE Invalid sample count for the 3090 processor only) 
(1OS Service) 
|} +74 | +4A | R799RES 2 | Reserved 
| Sub-type 10 (DDMN) Data Section: 
+0 +0 R79ATWSR 4 | binary DMDTTSWR Time-weighted average service rate for this domain 
+4 +4 R79AMPLT 2 binary DMDTMPLT Multiprogramming level target 
+6 +6 R79ARUA 2 binary DMDTRUA Average number of ready users 
ee +8 +8 R79AGOOU 2 binary DMDTGOOU Average number of users being swapped out 
| +10 | +A R7SACMPL 2 binary DMDTCMPL Current MPL value 
+12 | +C R79AOUTU 2 binary DMDTOUTU Average number of users swapped out 
+14 | +E R79AINCU 2 binary DMDTINCU Average number of swapped-in users 
+16 | +10 R79ATCTL 2 binary DMDTWT Target control value 
DMDTAOBJ 
| DMDTDOBJ 
| DMDTFWKL 
+18 | +12 R79ACIDX - 2 binary DMDTCIDX Contention index 
+20 | +14 R79ANSW 2 binary DMDTNSW Number of non-swappabie users 
+22 | +16 R79ADMNO 1 binary DMDTNO Domain number 
+23 | +17 R79RESV1 1 Reserved 
+24 | +18 R79RESV2 1 Reserved 
+25 | +19 R79ATYPE 1 binary DMDTWT Type of MPL target control 
DMDTAOBJ W — weighting factor 
DMDTDOBJ A — performance objective AOBJ 
DMDTFWKL D — performance objective DOBJ 
F — performance objective FWKL 
+26 1 +1A R79AIPS 2 | EBCDIC | WMSTiD Current IEAIPSxx member 
+28 | +1C R79ACPU 4 | EBCDIC | WMSTIPC CPU service coefficient 
| +32 | +20 R79AIOS 4 EBCDIC | WMSTIPI 1/O service coefficient 
+36 | +24 | R79AMSO 4 EBCDIC | WMSTIPM MSO service coefficient 
+40 | +28 | R79ASRB 4 | EBCDIC | WMSTIPB SRB service coefficient 
+44 | +2C R79ATWET 4 binary DMOTTWET Average first period TSO transaction response time 
+48 | +30 R79ADMLO 2 binary DMDTLO Minimum multiprogramming level (MPL) 
+50 | +32 R79ADMHI 2 binary DMDTHI Maximum multiprogramming level (MPL) 
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o~ 
| otteets [| Name [Length [Format | source [Description OT, 


Sub-type 11 (PGSP) Control Section: There is one control section followed by a data set section for each data set in the report. 
+0 | +0 R79BETYP | 1 EBCDIC | Internal Type of data that follows: 
P — PAGE data sets 
S — SWAP data sets 
+1 +1 3 Reserved 
Sub-type 11 (PGSP) Data Set Section: 
+0 +0 R79BSALC 4 binary EPGDSALC Number of slots/sets in this data set 
+4 +4 R79BSAVL 4 binary PARESLTA Number of slots/sets available 
+8 +8 R79BSLBD 4 binary EPGDSLBD Number of bad slots/sets 
+12 | +C R79BSUSE 4 binary EPGDSUSE Number of samples that indicate ASM is using the data set 
+16 | +10 R79BSIOS 4 binary IORSION Number of SSCH instructions issued for the data set 
+20 | +14 R79BREQS 4 binary IORTREQ Number of pages transferred to/from the data set 
+24 | +18 R79BFLG 1 binary Flags 
Bit Meaning When Set 
EPGDSBAD 0 Indicates that the data set is bad 
EPGDPLBA 1 Indicates a PLPA data set 
EPGDCOMM 2 Indicates a common data set 
EPGDDPLX 3 Indicates a duplex data set 
EPGDLOCL 4 Indicates a local page data set 
Internal 5 Indicates a paging data 
Internal 6 Indicates swapping data 
7 Indicates that the data set accepts VIO pages 
+25 | +19 R79BDEV 1 binary EPGDDEV Device type 
+26 | +1A R79BDADR 3 EBCDIC | EPGDDADR Device number ae 
+29] +1D] R79BVSER 6 EBCDIC | EPGDVSER Volume serial number te. ae 
+35 | +23 R79BDSN 44 EBCDIC | PGDSN Data set name 
+79 | +4F R79BFL2 1 binary Flags 
Bit Meaning When Set 
0 Multiple exposure device 
1 Alternate control unit device 
2-7 Reserved 
+80 | +50 R79BRESV 12 binary Reserved 


Sub-type 12 Channel Path Data Control Section: (one per record) 


R79CSMP binary CPTSAMP Number of samples as weighted by SRM 





Sub-type 12 Channel Path Data Section: (one per channel path) 


+0 +0 R79CPID 1 binary internal Channel path identifications 
+1 +1 R79CFG2 1 binary lOCDS Channel flags 
Bit Meaning When Set 
0 Reserved 
1 Reserved 
2 Block multiplexor 
3 Byte multiplexor 
4-7 Reserved 
+2 +2 R79CRV3 2 Reserved 
+4 +4 R79CBSY 4 binary CPMTBUSY Number af SRM samnlies in which the channel pain was 


busy 
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[offsets [Name cength | Format 








Sub-type 13 I/O Queuing Configuration Control Section for 308x, 908x, and 4381 processors: (one per logical control unit described 
by triplet (SMF79DCS) 


+0 


+2 
+4 


+8 
+10 


+0 


+2 
+4 


+8 
+A 


R79DID1 


R79DNTR 
R79DCPDS 


R79DCPDL 
R79DCPDN 


binary 


binary 


binary 


binary 


binary 


EIOQLCUN 


internal 


internal 


internal 


EIOQCHPN 


Logical control unit identifier 


Number of triplets following 


Offset to 1/O queuing configuration data section relative 
to beginning of 1/O queuing configuration control section 


Length of 1/O queuing configuration data section 


Number of 1/O queuing configuration data sections for 
LCU 


Sub-type 13 I/O Queuing Configuration Data Section for 308x, 908x, and 4381 processors: (one per channel path within a logical 
control unit, described by triplet R79DCPDS) 


R79DCPID 
R79DCPST 


R79CUN 

R79DCU1 
R79DCU2 
R79DCU3 
R79DCU4 


1 
1 


2 
2 
2 
2 
2 


binary 


binary 


binary 
binary 
binary 
binary 


binary 


ElIOQCHPN 
EIOQCPST 


EIOQCUN 
EIOQCU 
ELOQCU 
EIOQCU 
EIOQCU 


Channel Path Identifier 
Channel Path Status 


Meaning When Set 

Channel path installed 

Channel path online 

Channel path varied 

Channel path offline to all devices of the LCU 
Channel path connection to devices of the LCU 
altered by VARY PATH processing 

5-7 Reserved 


BRBWN-OD 
marly 


Number of control units attached 
First control unit identifier 
Second control unit identifier 
Third control unit identifier 


Fourth control unit identifier 


Sub-type 13 1/O Queuing Data Section for 308x, 908x, and 4381 processors: (one per logical control unit, described by triplet 


+0 +0 
+1 +4 
+2 +2 
t4 +4 
+6 +6 
+8 +8 
+10 | +A 
SMF79ASS) 
+0 +0 
+1 +14 
+2 +2 
+4 | +4 
+8 +8 
+12) +C 
+16 | +10 
+20 | +14 
+24 | +18 
+28 | +1C 
+30 1] +1E 


R79DDST 


R79DICT 
R79DABY 


R79DTIS 
R79DSIS 
R79DCUB 


R79DDVB 


R79DQUE 


R79DID2 


1 


NO 


binary 


binary 


binary 


binary 
binary 


binary 


binary 


binary 


binary 





EIOQNCPS 


EIOQICNT 
EIOQABY 


EIOQATIS 
EIOQASIS 
ElIOQACUB 


EIOQQADVB 


_EIOQAQUE 


EIOQLCUN 


pA nn EE EEE a fe pt 


Reserved 
Data status 


Bit Meaning 

0 No STCPS data available 

1 Reserved 

2 No hardware measurements available 
3-7 Reserved 


Count of invalid samples 


Number of samples when all channel paths in the LCU 
were busy 


Number of initial selection attempts 
Number of successful initial selections 


Number of initial selection attempts unsuccessful due to 
control unit busy 


Number of initial selection attempts unsuccessful due to 
device busy 


Number of requests queued for the LCU (accumulated at 
initial selection time) 


Logical control unit identifier 
Reserved 
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ors [Name [nnetn] Format [Sous [SSC erp 


Sub-type 14 I/O Queuing Control Section for 3090 Processors (described by triplet SMF79QSS) 


+0 


+1 
+4 


+0 


+4 
+4 


R79EGFLG 


R79EGSAM 


1 


4 


binary 


CMPTSAMP 


Global 1OQ status 


Bit Meaning when set 

0 Data invalid—channel measurement facility failed 
1 Diagnose interface failure 

2-7 Reserved 


Reserved 


CMPT sample count 


Sub-type 14 1/0 Queuing Configuration Control Section for 3090 processors: (one per logical control units described by triplet 


SMF79DCS) 
+0 +0 
+2 +2 
+4 +4 
+8 +8 
+10 | +A 


R79EID1 
R79ENTR 
R79ECPDS 


R79ECPDL 
R79ECPDN 


2 


EBCDIC 
binary 


binary 


binary 


binary 


1IOCDS 
internal 


internal 


internal 


internal 


Logical control unit identifier 
Number of triplets following 


Offset to 1/O queuing configuration data section relative 
to beginning of I/O queuing configuration control section 


Length of {/O queuing configuration data section 


Number |/O queuing configuration data sections for 
the LCU 


Sub-type 14 1/O Queuing Configuration Data Section for the 3090 processor: (one per channel path within a logical control unit. 


Described by triplet R79ECPDS) 


+0 
+4 


+2 
+4 
+6 
+8 
+10 
+12 


+16 
+20 


+0 


+1 


+2 
+4 
+6 
+8 
+A 
+C 


+10 


+14 


R79ECPID 
R79ECPST 


R79ECUN 
R79ECU1 
R79ECU2 
R79ECU3 
R79ECU4 
R79ECUB 


R79EPT 
R79EPB 


1 
1 


4 


binary 


binary 


binary 
binary 
binary 
binary 
binary 
binary 


binary 


binary 


lOCDS 


internal 


IOCDS 
1OCDS 
1OCDS 
1OCDS 
IOCDS 
HSA 


HSA 


CMPTBUSY 


Channel path identifier 
Channel path status 


Bit Meaning when set 


Channel path installed 

Channel path online 

Channel path varied 

Channel path offline to all devices of the LCU 
Channel path connection to devices of the LCU 
altered by VARY PATH processing 

5-7 Reserved 


WN © 


Number of control units attached 
First contro! unit identifier 
Second control unit identifier 
Third control unit identifier 
Fourth contro! unit identifier 


Number of initial selection attempts that were 
unsuccessful because control unit was busy 


Number of !/O operations accepted on this channel path 


Number of samples when channel path was busy 
(total samples is R7QEGSAM). 


Sub-type 14 |/O Queuing Section for the 3090 processor: (one per logical control unit, described by triplet SMF79ASS) 


+0 
+2 


43 
+4 
+8 


+0 
+2 


+3 
+4 
+8 


R79EID2 
R79EDST 


R79EQSM 
R79EQCT 


2 
1 


4 


EBCDIC 


binary 


binary 


binary 
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1OCDS 


HSA 
HSA 








Logical control unit identifier 
Data status 
Bit Meaning when set 


Reserved 
No hardware measurements available 


ee } om} Pen FR 
oe 


KJ — © 


Reserved 


Accumulated length of CU-HDR queue 


Number of entries placed on the CU-HDR queue 





- / 




















Record Type 80 (50) — RACF Processing Record 
Record Type 81 (51) — RACF Initialization Record 





Record types 80 and 81 are written by RACF during RACF initialization and 
processing. For information about record types 80 and 81, refer to SPL: Resource 
Access Control Facility (RACF): Installation Reference Manual, SC28-1343. 





Chapter 6. SMF Records 6-221 








Record Type 82 (52) — Security 





Record type 82 is a security record used to record information about the events 
and operations of the Programmed Cryptographic Facility Program Number 
(5740-XY5). The record length is 45 bytes plus the length of the variable 
relocate sections. 


Record type 82 is written to the SMF data set at the completion of each of the 
following cryptography functions: 


e Initialization. | 
The record is written when the Programmed Cryptographic Facility is 


initialized, either when cryptography is started or as a part of the key 
generator utility program. 


e Start. 


The record is written by ICTMKMO1 when a START command is issued for 
cryptography. 


e@ Stop. 


The record is written by ICTMKMO1 when a STOP command is issued for 
crytopgraphy. 


e@ Generation of an operational key. 


If specified in the initialization options for cryptography, ICTMKM04 
writes a record after processing each GENKEY macro instruction. 


e Transformation of an operational key. 


If specified in the initialization options for cryptography, ICTMKMO04 writes 
the record after processing each RETKEY macro instruction. 


e Execution of the key generator utility. 


The record is written by ICTMKG00 after the execution of the key generator 
utility program, thus providing a record of changes to the cryptographic key 
data set (CKDS). 


Record type 82 consists of a header section and five possible relocate sections. 
The header section identifies the RACF user ID and group name or the job and 
step name of the non-RACF cryptography user, the cryptography function that 
the record describes, and the return code issued by the function. The header 
section is 45 bytes long. 
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The five possible variable relocate sections are: 


e Key generator utility, which indicates changes made by the utility to the host 
system master key, the local keys, the cross keys, and the remote keys. The 
length of the section is 6 bytes. 


e GENKEY function, which indicates the action taken in response to a GENKEY 
macro instruction. The length of the section is 27 bytes. 


® RETKEY function, which indicates the action taken in response to a RETKEY 
macro instruction. The length of the section is 11 bytes. 


e Cryptography initialization, which describes the SMF recording options in 
effect at initialization and the cryptography function and key manager user 
SVC numbers. The length of the section is 7 bytes. 


e Installation data, which contains any information supplied by an installation 
user exit routine. The maximum length of the section is 66 bytes. 


Note: The number of relocate sections depends on the type of action taken. For 
instance, the record written when the Programmed Cryptographic Facility stops 
consists only of the header section. When the Programmed Cryptographic 

Facility has previously been initialized within the same IPL, the record written 
when cryptography starts also consists of only the header section. The number of 
relocate sections is indicated in CRY82VCT (offset 37). 


Using the ICTSMF82 and ICTCRY82 macros: Because record type 82 cannot be 
mapped using the IFASMFR macro, you must use two mapping macros to 
symbolically address record type 82. The macros are supplied on SYS1.MACLIB. 
ICTSMF82 maps the fields in record type 82 whose name starts with SMF. For the 
Programmed Cryptographic Facility, ICTSMF82 maps the fields addressed by 
offsets X‘O’ through X‘16’. ICTCRY82 maps the fields in record type 82 whose 
name starts with CRY. For the Programmed Cryptographic Facility, ICTCRY82 
maps the fields addressed by offsets X18’ through X‘2C’ and the variable relocate 
sections. 


The format is: 


= sa — een 


sh SMF82LEN | 2 | binary internal |_ Record length 
[2 | smreasec | 2 [binary |internai | __ Segment descriptor 


YT - iy - 


rs_[ 8 _[swrazary [1 [binary [iernat | Records SOS 


SMF82TME binary {SVC 11 or Time, in hundredths of a second, record was moved to 
SVC 83 the SMF buffer 
A SMF82DTE packed |SVC 11 or Date record was moved to the SMF buffer, in the form 
SVC 83 OOY YDODF where F is the sign 
14 EBCDIC | JMRCPUID or System identification (taken from S!1D parameter) 
SMCASID 


ieee so a a 


(Continued) 







Meaning When Set 










Reserved 
5 MVS/XA 
6 VS2 
7 VS1 
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Sacuaiy! product identifier: X‘0001' for 5S ainied 
Cryptographic Facility (Program number 5740-XY5) 


Jobname or, for RACF users, userid 




















Stepname or, for RACF users, RACF group name. | 












in TIOT or 
“CRY82FLG binary internal 
contain RACF user !D and group name. 
1-7 Reserved 
44. | 2C | CRY82RTC {binary internal Return code issued by function or X‘FF’ if function 
. | , 7 1 terminated abnormally 
CRY82SMK =a ICTMKGOO Host system master key flags 
Bit Meaning When Set 
0 Host system master key was successfully 
changed 
1-7 Reserved 


“18 “CRYS2USR | EBCDIC TIOCNJOB 
in TIOT or 
ACEEUSAI 
in ACEE 
ACEEGREPN in 
Meaning When Set 
(When this bit is off, the fields contain the 
| CRY82VCT _ | cRYB2vcT | 2 [binary | internal Number of variable relocate sections | 
wy Generator Utility Relocate Section: 
CRY82DTP ibinary |ICTMKGOO Data type indicator: X‘01’ for key 2 Porn oR: utility 
+3 CRY82LMK ‘binary |ICTMKGOT Local key flags 
Bit Meaning When Set 
0 At least one local key was updated 
1 At least one local key was added 
2 At least one local key was deleted from 
the CKDS 
| | 3-7 Reserved 


A 
CRY82GRP EBCDIC | TI OCSTEP 
ACEE 

0 Fields CRYS2USR and CRY82GRP 

job name and step name.) 
CRY82FTN | binary oe Function code _ 

Code Meaning 
Key generator function 
GENKEY function 
RETKEY function 

Start cryptography 
Stop cryptography 
=| CRY82DLN soe ICTMKGOO | Length of the data thatfollows = sd 
+4 CRY82CMK binary | ICTMKGO1 Cross key flags | 

Bit Meaning When Set 

0 At least one pair of cross keys was updated 

1 At least one pair of cross keys wes added 

2 At least one pair of cross keys was deleted 
from the CKDS 

3-7 Reserved | 








+5 ‘CRY82RMK ICTMKGO1 — Remote key flags 
Bit Meaning When Set 
0 At least ane remote kev was undated 
1 At least one remote key was added 
2 At least one remote key was deleted from 
the CKDS : 
3-7 Reserved 


(Continued) 
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o 
UY 

















ad 
“GENKEY Function Relocate Section: oe _ | 
ee CRY82DTP binary ICTMKM04 Data type indicator: X‘02’ for GENKEY function 


CRY82DLN pp ICTMKMO4 Length of the data that follows 
CRY82ID (64 bytes) 


CRY82GFG binary ICTMKM04 GENKEY activity flags 
5-7 Reserved 


CRY82LK1 | EBCDIC | GENKEY | ‘LOCKEY’ key name 
| LOCKEY 


| parameter 


“+11 | CRY82LK2_ | EBCDIC | GENKEY | | “‘LOCKEY2' key name 
LOCKEY2 : 
| | parameter | | = | 
+19 CRY82REM EBCDIC GENKEY ! "REMKEY’ key name 
REMKEY 
parameter 
RETKEY Function Relocate Section: 
+0 CRY82DTP binary ICTMKMO04 Data type indicator: X‘03’ for RETK EY function 


Pet fo CRY82DLN eine owe ICTMKMO4. Length of the data that follows 


mil CRY82RFG Te ICTMKMO04 | RETKEY activity flags 
+3 


Bit Meaning When Set 
CRY82RKN EBCDIC | RETKEY 
REMKEY 
| Parameter 


0 installation data relocate section was omitted 
from this record because the data supplied by 
Cryptography Initialization Relocate Section: 
CRY82DTP 


Bit Meaning When Set 

0 ‘LOCKEY’ parameter was in error 
1 ‘LOCKEY2’ parameter was in error 
2 ‘REMKEY’ parameter was in error 
3 


‘OPKEY’ was generated by the key manager. 
When bit 3 is off, ‘OPKEY’ was supplied to 
the key manager. 

Installation data relocate section was omitted 
from this record because the data supplied by 
installation exit exceeded the length of 















the installation exit exceeded the length of 
CRY82ID (64 bytes) 
Reserved 


"REMKEY’ key name 


















| I\CTMKGOO 
| (CTMKMO1 


+4 ~ | CRYB2DLN binary | 1CTMKGOO Length of the data that follows | 
ICTMKMO1 


+2 CRY82SMF binary {ICTOPTNS SMF option flags 
| Bit Meaning When Set 
SMF records not written for GENKEY 
function 
| SMF records not written for RETKEY 
| function 
| Reserved 


| +3 CRY82SIM binary |ICTOPTNS Cryptography function user SVC number 
in the form X‘cccc’ 
a = CRY82KMG i ee | ICTOPTNS Key manager user SVC number in the form 
| a | X*cccc’ 


Data type indicator, X‘04' for initialization 
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installation Data Relocate Section: 


| CRY82DTP a i ICTMKGOO, 


ICTMKMO4 


CRY82DLN binary | ICTCKG90, 
ICTMGR9O, 
CRY82ID ICTCKGQO, 
ICTMGR90, 
ICTMGR95 
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Data type indicator: X‘05’ for installation 
data . 
Length of the data that follows 
Installation data written by an installation user | 
exit routine. The maximum length is 64 bytes. 
% e 





























Record Type 82 (52) — Security 





Record type 82 is a security record used to record information about the events 
and operations of the Cryptographic Unit Support Program Number (5740-XY6). 
The record length is 41 bytes plus the length of the variable relocate sections. 
Record type 82 is also written by the Programmed Cryptographic Facility 
(5740-XY5). 


Record type 82 is written to the SMF data set at the completion of each of the 
following cryptography functions: 
e Initialization. 
The record is written when the Cryptographic Unit Support is initialized, either 
when cryptography is started or as a part of the key generator utility program. 
e Start. 
The record is written by [CUMKM11 when a START command is issued for 
cryptography. 
@ Stop. 
The record is written by ICUMKM11 when a STOP command is issued for 
cryptography. 
e Modify. 
The record is written by ICUMKM11 when a MODIFY command is issued for 
= cryptography. 
( e Unit check. 


The record is written by ICUMKM11 when the cryptographic unit is switched 
offline and then brought online again. j 


e Generation of an operational key. 


If specified in the installation options for cryptography, ICUMKM 14 writes 
a record after processing each GENKEY macro instruction. 


e Transformation of an operational key. 


If specified in the installation options for cryptography , [CUMKM14 writes 
the record after processing each RETKEY macro instruction. 


e Execution of the key generator utility. 


The record is written by ICUMKG1O0 after the execution of the key generator 
utility program, thus providing a record of changes to the cryptographic key 
data set (CKDS). 


Record type 82 consists of a header section and six possible relocate sections. 
The header section identifies the RACF user [D and group name or the job and 
step name of the non-RACF cryptography user, the cryptography function that 
the record describes, and the return code issued by the function. The header 
section is 45 bytes long. 
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The six possible variable relocate sections are: 


e Key generator utility, which indicates changes made by the utility to the host 
system master key, the local keys, the cross keys, and the remote keys. The 
length of the section is 6 bytes. 


e GENKEY function, which indicates the action taken in response to a GENKEY 
macro instruction. The length of the section is 27 bytes. 


@ RETKEY function, which indicates the action taken in response to a RETKEY 
macro instruction. The length of the section is 11 bytes. 


e Cryptography initialization, which describes the SMF recording options in 
effect at initialization and the cryptography function and key manager user 
SVC numbers. The length of the section is 7. bytes. 


e Installation data, which contains any information supplied by an installation 
user exit routine. The maximum length of the section is 66 bytes. 


e@ Cryptographic unit data, which indicates the status of the cryptographic unit. 
The length of the section is 6 bytes. 


Note: The number of relocate sections depends on the type of action taken. For 
instance, the record written when the Cryptographic Unit Support stops consists 


only of the header section. The number of relocate sections is indicated in 
CRY82CVT (offset 41). 


Using the ICUSMF82 and ICUCRY82 macros: Because record type 82 cannot be 
mapped using the IFASMFR macro, you must use two mapping macros to 
symbolically address record type 82. The macros are supplied on SYS1 MACLIB. 
ICUSMF82 maps the fields in record type 82 whose name starts with SMF. For the 
Cryptographic Unit Support, ICUSMF82 maps the fields addressed by offsets X‘0’ 
through X‘16’. ICUCRY82 maps the fields in record type 82 whose name starts 
with CRY. For the Cryptographic Unit Support, ICUCRY82 maps the fields 
addressed by offsets X‘18’ through X‘2C’ and the variable relocate sections. 


The format is: 


or ater Pee te ge 
ee SMF82LEN | 2 |binary internal |_Record length 
[2 [2 | swraases [2 [inary finernat | Seomenedesriptor 


Ht - se 7 


SMF82TME binary {SVC 11 or Time, tn hundreaths of a second, record was moved to 
SVC 83 the SMF buffer 


Date record was moved to the SMF buffer, in the form 
SVC 33 OOYYDODF where F is the sign 


14 EBCDIC | JMRCPUID or System identification (taken from SID parameter) 
SMCASID 
[is [42 | SMra2inc [4 [oinary finvernes | Length of record header 


(Continued) 












System indicator 
Bit Meaning When Set 










0-5 Reserved 
6. ~VS2 
7 VS1 
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wt 

















¢ 


Cc 








dd 
SMF82TID binary Security product identifier: X‘O002’ for Cryptographic 
Unit Support (Program number 5740-X Y6) 


CRY82USR - EBCDIC | TIOCNJOB Jooname or, for RACF users, userid 
in TIOT or 
ACEEUSAI 
in ACEE 

CRY82GRP EBCDIC | TIOCSTEP Stepname or, for RACF users, RACF group name. 
in TIOT or 
ACEEGREPN in 
ACEE 


CRY82FLG binary | internal Flags 
Bit Meaning When Set 
0 Fields CRY82USR and CRY82GRP 
contain RACF user |D and group name. 
(When this bit is off, the fields contain the 
job name and step name.) 
1-7 Reserved 


il CRY82VCT | 2 |binary internal Number of variable relocate sections 


CRY82FTN binary internal Function code 
Code Meaning 
Key generator function 
GENKEY function 
RETKEY function 
Start cryptography 
Stop cryptography 
Modify cryptography 
7 Hardware check 


44 2C CRY82RTC binary internal Return code issued by function or X‘FF’ if function © 
terminated abnormally 


ey Generator Utility Relocate Section: | 
CRY82DTP binary | |ICUMKG10 Data type indicator: X‘01' for key generator utility 


a. ae CRY82DLN ae ee ICUMKG10 Length of the data that follows 


+2 CRY82SMK binary Host system master key flags 
Bit Meaning When Set 
0 Host system master key was changed. This bit 
is set even if an error occurs in the key generator. 
1-7 Reserved 
+3 CRY82LMK binary ICUMKG11 Local key flags 
Bit Meaning When Set 
At least one local key was updated 
At least one local key was added _ 
At least one local key was deleted from 
the CKDS 
Reserved 
+4 CRY82CMK binary ICUMKG11 Cross key flags 
Bit Meaning When Set 
At least one pair of cross keys was updated 
| At least one pair of cross keys was added 
At least one pair of cross keys was deleted 
from the CKDS 
Reserved 




















+5 CRY82RMK binary ICUMKG11 Remote key flags 
Bit Meaning When Set 
At least one remote key was updated 
At least one remote key was added 
At least one remote key was deleted from 
| the CKDS 
Reserved 


(Continued) 
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oe [am fewer [eee 
GENKEY Function Relocate Section: 
+0 CRY82DTP binary ICUMKM14 Data type indicator: X‘'02’ for GENKEY function 


| +4 | _CRY82DLN eC ICUMKM14 Length of the data that follows 


| CRY82GFG ll ICUMKM14 GENKEY activity flags 


Bit Meaning When Set 
+3 CRY82LK1 EBCDIC | GENKEY 

LOCKEY 

parameter | 
~CRY82LK2_ EBCDIC GENKEY ‘LOCKEY2’ key name 

LOCKEY2 

parameter ee 
 CRY82REM EBCDIC | GENKEY ‘REMKEY’ key name 

REMKEY 

parameter 


RETKEY Function Relocate Section: —— : : . 
+0 CRY82DTP 1 binary | ICUMKM14 Data type indicator: X‘03’ for RETKEY function 


ce CRY82DLN | 1 |binary | ICUMKM14 Length of the data that follows 


CRY82RFG binary ICUMKM14 RETKEY activity flags 
| Bit Meaning When Set 

0 Installation data relocate section was omitted 
from this record because the data supplied by 
the installation exit exceeded the jength of 
CRY82ID (64 bytes) 

: Reserved 
+3 


CRY82RKN EBCDIC | RETKEY ‘REMKEY’ key name 
REMKEY | 
. parameter 


Cryptography Initialization Relocate Section: 
CRY82DTP 















8) ‘LOCKEY’ parameter was in error 

1 ‘LOCKEY2’ parameter was in error 

2 "REMKEY’ parameter was in error 

3 ‘OPKEY’ was generated by the key manager. 


When bit 3 is off, ‘OPKEY’ was supplied to 
the key manager. 
4 Installation data relocate section was omitted 
from this record because the data supplied by 
installation exit exceeded the length of 
CRY82!1D (64 bytes) 
Reserved 


‘LOCK EY’ key name 





























ICUMKG10 
ICUMKM11 


+1 CRY82DLN 1 binary ICUMKG10 Length of the data that foilows 
ICUMKM11 


+2 CRY82SMF binary {CUOPTN2 SMF option flags 
Bit Meaning When Set 
0 SMF records not written for GENKEY 
function 
1 SMF records not written for RETKEY 
function 
2-7 Reserved 


+3 CRY82SIM binary ICUOPTN2 Cryptography function user SVC number 
in the form X’cccc’ 


CRY82KMG binary ICUOPTN2 Key manager user SVC number in the form 


X‘ecece 
IN Wwhele& 


Data type indicator, X’04’ for initialization 











(Continued) 
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wy 


























ee ee a —_—_ 
| Installation Data Relocate Section: | Data Relocate Section: 

ba il on 
“ey — tial 
Pe - _ 


Cryptographic Unit Data Relocate Section: 
ICUMKM11 


nl — ul 

+ CRY82DLN binary |ICUMKG10 
ICUMKG04 

al CRY82CID aa ICUMKG10 






















ICUMKG10, 
ICUMKM14 


ICUCKG90, 
ICUMGRQO, 
ICUMGR95 


ICUCKG90, 
ICUMGRSO, 
ICUMGR95 


Data type indicator: X‘0O5’ for installation 
data 








Length of the data that follows 






Installation data written by an installation user 
exit routine. The maximum length is 64 bytes. 
































ICUMKG10 
ICUMKG04 


Data type indicator: X‘O6’ for Cryptographic 


unit data 





Length of the data that follows 













Cryptographic unit address 






ICUMKM11 
ICUMKG04 
ICUMKM11 
ICUMKG10 







Cryptographic unit status 










Reserved 


+5 CRY82CST binary 
ICUMKG04 Bit Meaning when set 
ICUMKM11 
Q Unit is online and available 
1 Unit is unavailable 
2 Unit check-key verification failed 
3 Unit check-key verification successful 
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Record Type 90 (5A) — System Status Record 


Record type 90 is written whenever certain operator commands are issued. The 
record is created for operator tracking and reporting of reliability data and allows 
the installation to establish availability statistics. The following list of commands 
causes the associated module to write the record: 


Command Module Command Module 
SET TIME IEE6503D HALT EOD IEE70110 
SET DATE IEE6503D SET OPT IEEMB812 
SETDMN IEE8603D SET ICS IEEMB812 
SET IPS IEEMB8 12 SETSMF IEEMB823 
SET SMF IEEMB8 23 SET MPF IEECB805 
SWITCH SMF IEEMB829 SET DAE ADYTRNS 
SET PFK IEECB816 


In addition, the record is written by IEEMB823 during IPL processing. 
The record length is variable. 


Note: The subtype indicator is defined at offset 0 in the product section. 
The format is: 


ee lotion aon la 
Pawraowen [2 [inary liners! | Recordiongh 
SS lw in. |aaee 
[1 [inary [svess | Weaderfipbyte SSCS 
eC a 














SMF9OTME 


binary SVC 83 Time, in hundredths of a second, record was moved | 
to SMF buffer 
SMF9ODTE 


packed | SVC 83 Date record was moved to SMF buffer, in the form | 
OOYYDDDF, where F is the sign. 
| | SMCASID System identification (taken from the SID parameter.) 
20 SMF9OPOF ‘including 


2 
2 
1 
1 
4 
ia 
[2a [ve | swrsortn [2 | binary [intemat | tenath of product section OSS 


pis | 2] | 2 [binary internat | Reserved 
binary internal Offset to product section from start of record, including | 
the RDW 





| 26 | 1A | sMFgOPON Number of product sections | 


binary internal Offset to data section from start of record, including 
the RDW 


Length of data section 
Number of data sections 


SMFSODOF 


NO 
8 

= 

QO 


Product Section: 






+0 SMF9OTID 2 binary Sub-type identifier 
1 SET TIME 7 HALTEOD- 13 SETSMF 
2 SET DATE! 8 IPLPROMPT 14 SET MPF 
3 SETDMN2 9 IPL SMF 15 SET SMF (to 
4 SETIPS 10 IPL SRM restart SMF) 
5 SET SMF 11 SET OPT 16 SET DAE 
6 SWITCHSMF 12 SETICS 17 SET PFK 


+2 


a SMF9ORVN EBCDIC| internal Record version number2 , 
| | smrgopnm | 8 | escpiclinternat Product name 


"Subtype 2 is written only if the CLOCK parameter is not specified on the SET DATE command. Any SET DATE command 
that uses the CLOCK parameter produces a subtype 1 record. 


2Programs that need to handle sub-type 3 (SETDMN) records from Release 1.3 and earlier releases can look at SMFOORVN to 
determine which lengths and offsets to use, This field contains X‘02’ if the sub-type 3 record was produced by Release 1.3 and 
X‘O1' if it was produced by an earlier release. 
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( 











a 


Self-Defining Section: For subtype 5, 9, 13, and 15 only! 


SMFS00OSM i i Offset to IPL SMF or SET SMF section from start of 
record, including the ROW 


== SMFSOLSM il land sar icnaieheaksieiioton Length of IPL SMF or SET SMF section 


(+6 | 6 |SMF9ONSM| 2 | binary | | Number of PLSMF or SET SMF sections 


SM FOOODA binary Offset to data section from the start of record, 
including the ROW 


cee SMF9OLDA 2a eral _}_ tong of ue treo Length of data set section 
+14 | — | SMFSONDA | 2 [binary | Number | Number ofdatasetsections | data set sections 


+16 10 SMFSOOWK binary Offset to subsystem section from the start of the 
record, ee ee oe Ro __________ the ROW 


[+20 | 14 | smroocwk| 2 | binary | | Length of subsystem section == “asd of subsystem section 

ee 
2418 [smrsooor| 4 [binary [internal | _Offeet to subsystem parameter segment 
[28 [1c [smrso.ot| 2 | binary [internat | _Lenathof subsystem parameter segment 
f+30 [te | smroonot| 2 [binary [internal —|__Number of subsystem parameter segments 


IPL. SMF/SET SMF/SETSMF Sections eens 5,9, 13, and 15): 
SMF9SOMAX 4 EBCDIC | SMCAMDM Current value for MAXDORM in MMSS format 


er SMF9OSTA EBCDIC | SMCASSTS Current value for STATUS in HHMMSS format 

}+10 | A | SMF9OJWT EBCDIC | SMCAJJWT Current value for JWT in the format hhmm 

Ta |e [swroosyi | 4 | eacoic|[swcasio 
SMF9OBUF | 1 | binary |SMCAMNBF Minimum number of buffers 

SMF9OBUM| 1 | binary _|SMCAMXBF Maximum number of buffers 


SMF Options 
Bit When Set Indicates 














































14 SMF90SWT binary 
SMCAIPLR 0 PROMPT(ALL) 
SMCALIST 1 PROMPT(LIST) 
SMCAIPLR 2 PROMPT(IPLR) 
SMCAIPLR 3 PROMPT(NONE) 
SMCATDS 4 REC(PERM) 
SMCATDS 5 REC(ALL) 
SMCALDS : LISTDSN 
SMCALDS NOLISTDSN 


peat [se fsuoenve | Ws 


_SMFQOIIT pene SMCAITME Time of IPL 


a SMF90IDT | 4 | packed — SMCAIDTE Date of IPL 






SMF Data Set Section: There is a data set section for every SMF recording data set. The first data set is the 
active data set at IPL or SET SMF time. 


SMFSODSN EBCDIC | ROSDSNAM 















SMF data set name 












Subsystem Recording Section (Subtypes 5,9, or 15): There are entries for the SYS, plus an entry for each additional subsystem 
SMFSOWKN 


subsystem specified in the SUBSYS keyword in SMFPRMxx. 
Fy _ aia _ 


EBCDIC | SSTNAME 
1 For subtypes 5, 9, and 13, this field sainted to by SMF9ODOF. 






Name of subsystem 





DETAIL recording indicator 
Bit Meaning When Set 
0 Detail recording on 
1-7. Reserved 
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nN 
ae 
” 


| +10 | a | sMFgonmi | 2 | binary | SETDMIN New minimum MPL value 














se 
Subsytsem Recording Section (Subtypes 5, 9, or 15): (continued) 
5 | SMF9ORVE | Reserved 


+5 | 3 | 
1 +8 | SMF9OSVL | | binary |SSTINTVL Length of interval, in TOD clock format, between check} 
Y | | | point SMF records | 


| +16 | 10 | SMF9osYS binary |SSTRCDON Bit Representation of SMF record types 
Bit O corresponds to record type O 
30 | SMF9OEXN EBCDIC |EXITNAME 


Bit 255 corresponds to record type 255. If the bit is on 
| Switch SMF/Halt EOD Section (Subtypes 6 or 7): | 


(1), the record is enabled for recording. If the bit is 

off (0), the record is not enabled for recording. 
0 O- | SMF90SWO 10 1 EBCDIC RDSNAME 
MFQOSWN | EBCDIC | RDSNAME 


Posted New recording data set name 
MFSOIT | 


m —Toinery [SMcArTME 
MF90DT | packed SMCAIDTE | IPL date 







Description 



























Names of the active exits for this subsystem. Each 
sequentially listed exit name is 8-characters long. Up to 
15 exits can be specified. If less than 15 exits are 
specified, the remaining portion of the list is filled 
with binary zeros. 








Old recording data set name 





4 


”Q 


To fa 
20 [14 | smraorr | 4 
ie 










| SMF9ODTM | EBCDIC | Operator Response | System down time in the form hh-mm-ss or ‘u’ 
__| SMF9ORSN 


| EBCDIC Operator Response Reason for the IPL or ‘u’ 
SMFSOITM | ime, 


& 
0 


= 
3 
@ 
= 
® 
QO 
3 
o 


+ 
ie) 
~“ 


+ 
<e) 
a) 


” 


61 | 






| SET DATE/TOD Section (Subtypes 1 or 2): 
| Time before command was issued 


i +0 | 0 SMF90OTM | 4 packed 
Time Macro Old date before command was issued 


MFSONTM Time Macro Time after command was issued 


SM FQON DT | binary | Time Macro Date after command was issued 


Z 


SMCAITME Time, in hundredths of seconds, of IPL 
mp9oDTT | 4 SMCAIDTE Date, in the form OOYYDDDE, where F is the sign, 
| of IPL 


g 


+ 
© 


SMF90IPO | WMSTID Old IPS name 
| IEAIPS — designates the skeleton IPS. 
MBSUFFIX New IPS name 


SETDMN Section (Subtype 3): | 
| QO | SMF9ODDT 8 binary |SETDTOC Time of change 


9 |smrgopFG | 1 | binary |SETDFLGS Domain flags | | 


Value Meaning 
X ‘80’ Minimum MPL changed 
X ‘40' Maximum MPL changed 
X‘20' Weight changed 
X ‘10’ AOBJ changed 

amo. i i a g a 


+ 
ah 
o 


a 
0 


ET IPS Section (Subtype 4): | 
7 SMF9OTIP 8 binary Store Clock Set IPS time 


bj aid 









VOBJ changed 







xX ‘04' FWKL changed , 


ca 


"¢ a SWITCH operator command attempts to switch recording to a data set that is not empty, a data 


last condition exists and the new data set name in the subtype 6 record is left blank. 
In subtype 7 records, the old and new data set names are blank. 
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( 











Description 


[ores [me [wn mn 


| SETDMN Section (Subtype 3): (continued) 





SETDMAX New maximum MPL value! 


binary 





New weight value! 
New AOBJ value! 
New DOBJ value! 
New FWKL value! 


2 
3 


SMCIATME 


Time of IPL 
SMCAIDTE 


ar. SMFS9OIPS [Fi EBCDIC | WMSTID 
+16] 10 SMF9O0OPT EBCDIC | RMPTOPTN OPT parmlib Member used. 
[EAOPT —~— — indicates no OPT 
+24] 18 SMF9ODICS EBCDIC | ICSCNAME IEAICSxx parmlib member used. 
[EAICS** indicates no installation control specification. 





IPS parmlibo member used. 
IEAIPS—— — designates the skeleton IPS 


| SET OPT Command Section (Subtype 11): 





SMF9OTOP 8 binary Store Clock 


Time of OPT change 


i ae SMFQOOPO es EBCDIC | RMPTOPTN Old OPT parmlib member, IEAOPT -- — indicates 
no OPT 


New OPT parmlib member 


SMFS9OOPN EBCDIC | MBSUFFIX 


Command Section (Subtype 12): 


SMF9OTIC binary Store Clock Time of change 













+8 SMF9O0ICO EBCDIC | ICSCNAME Old parmlib member, IEAICS** indicates no installation 
control specification 
+16 SMF9OICN EBCDIC | MBSUFFIX New parmlib member 


8 

SET MPF Command Section (Subtype 14): 

SMF9OTMP 8 
8 





Store Clock 


i a SMF9OMPO LP EBCDIC | SMFSFX 


+16] 10 | SMF9OMPN Ce EBCDIC | MBSUFFIX 
SMF9OMPC ea EBCDIC | MBSUFFIX 


Time and date of change 


Name of old parmlib member or blanks if there is 
old MPFLSTxx parmlib member 


Name of new parmlib member 


Name of old parmlib member for color 


SET DAE Command Section (SUBTYPE 16): 


Store Clock Time of date and change 





Name of old parmlib member 


Cd SMF90D AO EBcDIC | DFLPLMEM 
46, SMF90DAN gz EBCDIC | DFLPLMEM 


- Name of new parmlib member 





EBCDIC ] internal Time of SET PFK change 


4g | +8 SMF9O0OPFO EBCDIC | internal Old PFK Parmlib member (written to object) 


8 
+8 8 
+16 SMF9OPFN ee | EBCDIC | internal New PFK Parmlib member 


"¢ the version number in SMF9ORVN equals X‘02’, the length of this field equals 2; otherwise, the length equals 1. 
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Record Type 100 (64) — Data Base 2 Statistics 
Record type 100 is written by DATABASE 2 (DB2) to record transaction data 


collected at event monitoring points. For more information about record type 100, 
see IBM DATABASE 2 System Planning and Administration Guide (SC26-4085). 
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Record Type 101 (65) — Data Base 2 Accounting 





Record type 101 is written by DATABASE 2 (DB2) to account for resources 
during a transaction. For more information about record type 101, see JBM 
DATABASE 2 System Planning and Administration Guide (SC26-4085). 


Record Type 102 (66) — Data Base 2 Performance 


Record type 102 is written by DB2 to record performance information. For 
more information about the type 102 record refer to JBM DATABASE 2 
System Planning and Administration Guide (SC26-4085). 
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Record Type 110 (6E) — CICS/VS Statistics f 


Record type 110 is written by CICS/VS to record transaction data collected at 
event monitoring points. For more information about the type 110 record, refer to 
CICS/OS/VS Version I Release 7 Customization Guide, SC33-0239. 
mt 
ee A 
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¢ Chapter 7: Field-to-Record Cross-Reference 


This appendix lists all of the fields in the SMF records in alphabetical order and 
identifies the record type containing each field. It also gives the displacement of 
the field within the record. 


Some records have sections of fields that are generated only when specific events 
occur, such as when IPL is completed or when a device is varied online or offline. 





The following abbreviations appear under the “offset’’ column to indicate the section 
of the record where the field is found: 


ACT Accounting section 

CHAN Channel section 

CHND Channel! data section 

CPU CPU section 

CPUD CPU data section 

CRYP Cryptography initialization relocate section (5740-XY5, -XY6) 
DCB DCB/DEB DASD extension entry 

DEV Device entry 

DEVD Device data section 

DSC Data set characteristics section 

EXT Extent entry 

GENK GENKEY relocate section ($740-XY5, -XY6) 
IDAT Installation data relocate section (5740-XY5, -XY6) 
ISAM ISAM extension section 

KG Key generator relocate section (5740-XY5, -XY6) 
MSS MSS IPL configuration section 

PERF Performance group period data section 

PRNT 3800 Printing Subsystem section 

REL Relocate section 

RETK RETKEY relocate section (5740-XY5, -XY6) 
STAT Statistics section 

STOR Storage section 

TAPD DCB/ DEB tape extension entry 

TAPU UCB tape extension entry 

UCB UCB section 

VARY VARY ONLINE,S and VARY OFFLINESS section 
VOL Volume entry 


For MVS/System Product, the fields are not abbreviated and are listed as they 
appear in the record. 
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~ *These records are for JES2. 


**These records are for JESS. 


Field Description 


Record Offset ‘ 
Type Dec. Hex. ‘ee 7 


—~, 





Accepting VIO pages 


ACCESS data section, offset of object 
ACCESS data section, length of object 
ACCESS data section, number of object 


Access-method interfaces option codes 


Accounting fields, job 


Accounting fields, step 


Accounting number, networking 


Accounting number, programmer's 
Address, CPU 


Address, line adapter 


Address, VTOC 


Address of lowest page in real 
contiguous storage 


Address space dispatching priority 


Address space identifier 


Address space swap sequences 


Allocation, device start time 


Allocation status indicator 


Alternate tracks, number of unused 


AOBJ value 
ASCB ready queue Jength 


Attentions on ending status of 
READ channel programs 


Attentions received 
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75 Page/Swap data set data section 
79 PGSP data set section 


41 36 24 
41 40 28 
41 42 2A 
14 250 FA 
15 250 FA 
5 121 79 
20 65 41 
26** 276 114 
30 Accounting section 
35 121 79 
4 ACT 

30 Accounting section 
34 ACT 


26* Network section 
57** Network section 
57* Network section 


26* 104 68 


22 CPU 

22 CHAN 

48* 72 48 

48** 80 50 2 
\ 

19 40 28 : 

22 STOR nase 

4 57 39 

30 Processor section 

34 57 39 

79 ARD/ARDSJ section 

79 ASD/ASDJ section 

79 SENOR section 

4 REL 

34 REL 

4 90 5A 


30 Identification section 
32 Identification section 


34 90 5A 
14 67 43 
15 69 43 
25** 42 2A 
19 50 32 


90 SETDMN section 
79 SRCS section 


50 40 28 (5735-RC2) 


50 36 24 (5735-RC2) 











Record Offset 
Field Oescription Type Dec. Hex. 








Average cycie time 
Average number of ready users 
Average number of slots used 


Buffers, number written 


79 CHANNEL section 


79 DOMN section 


75 Page/Swap data set section 


Beginning cylinder and track 64 EXT 
Bind failure or unbind reason code 39 116 74 
Block count for each volume 14 TAPD 
15 TAPD 
Block size 21 44 2c 
64 DSC 
Blocksize - Sort records 
maximum input 16 Data section 
output 16 Data section 

BUF parameter 0 22 16 
Buffer, date record was moved to ALL! 10 A 
Buffer, number of bytes in SMF ) 22 16 
Buffer, size of time-sharing 31 20 14 
Buffer, time record was moved to Au! 6 6 
Buffers, number allowed per terminal 31 26 1A 
before LWAIT 
Buffers, number allowed per terminal 31 24 18 
before OWAIT 

( | Buffers, number reserved on free queue 31 32 20 

\ Buffers, number of time-sharing 31 18 12 


23 Statistics section 


Burster-Trimmer-Stacker 6 PRNT 
Bus-out checks, number of 48** 66 42 
Byte count, printed 
actual 26* Print section 
estimated 26* Print section 
Bytes, number sorted | 16 Data section 
Bytes read, number of 4K 21 56 38 
_ Bytes written, number of 4K 21 59 3B 
‘Cards, input, number of 26* 208 DO 
26** 248 FS 
Cards, punched, number of 26 120 73 
cards generated to spool, number of 26° 216 D8 
26** 256 100 
Card-image records in DD DATA and 4 51 33 
DD* data sets read for step/job 5 51 33 


30 1/0 activity section 


Catalog name 61 75 48 

62 46 2E 

63 48 30 

64 44 2C 

65 75 48 

66. 75 4B 

ove, 67 44 2c 
( *These records are for JES2. 68 42 2A 
nail **These records are for JESS. 69 56 38 


Te xcept 2,3 
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*These records are for JES2. 
**These records are for JES3. 


Field Description 


Catalog record size 
Catalog record 


Catalog records 


CCHH, beginning 
CCHH, ending 
Channel path id 


Channel busy number of samples 
Channel identifier 

Channel model number 

Channel path samples, number of 
Channel path section identification 


Channel path status 


Channel path busy, number of samples 
Channel path busy, percent 
Character arrangement table names 


Class, job 


Class, associated with PGN 

Class, message 

Class, service 

Class, SYSOUT 

Cleaner actions, number of 
Collection period begin time stamp 
Collection period end time stamp 
Configuration indicator 
Contention index 


Command rejects, number of 
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Record 





Offset 
Type Dec. Hex. 


63 44 2c 
63 46 2E 
67 132 84 


61 208 DO 
65 208 DO 
66 208 DO 


63 136 88 
67 134 86 


64 EXT 

64 EXT 

4 DEV 

8 DEV 

9 DEV 

10 DEV 

11 DEV 

14 UCB 

15 UCB 

19 64 40 
21 26 1A 
22 CHAN 

30 EXCP section 
34 DEV 

40 DEV 

64 EXT 


69 42 2A 
73 Channel path data section 
79 CHANNEL section 


22 CHAN 
78 Subtype 1 |/O queuing data section 
22 CHAN 


78 Subtype 1 1/O queuing configuration data section 
Subtype 3 1/O queuing configuraiton data section 


73 Channel path data section 
79 Subtype 14 1/O queuing section 
6 PRNT 


5 75 4B 
26 89 59 


72 62 3E 
26 88 58 
39 90 5A 
6 42 2A 
21 41 29 
39 2 2 
39 10 A 
70 CPU section 

79 DDMN section 
48** 64 40 

















C 





*These records are for JES2. 
**These records are for JESS. 





Field Description 


Record Offset 
Type Dec. Hex. 





Common area page-ins 


Common area reclaims 


Completion code, JES2 
Completion code, JES3 


Completion code, job 


Completion code, step 


Completion code, transmission 
destination 


‘Completion code, transmission origin 


Component indicator 


Component or cluster name 


Configuration activity indicator 
Connect time; total for this device 
Continuous wait time limit 

Control! areas, number that were split 
Control interval size 

Control intervals, number of unused 


Control intervals, number that were 
split 


Conversion processor (CPU) 
identification 


Control unit busy delay 
Control units attached, number of 
Control unit (logical) identifier 


Control unit (logical) number 
Converter start time 
Converter start date 
7onverter stop time 
Converter stop date 


Copies, number printed with overlay 
Lopy groups 
Copy modification module name 


Count of READ channel programs 


4 EL 

30 Storage and paging section 
34 REL 

4 REL 

30 Storage and paging section 
34 REL 


45* 26 1A 
45** 25 19 


5 55 37 
30 Completion section 
35 55 37 


4 55 37 
30 Completion section 
34 55 37 


59 Transmission section 


59 Transmission section 
64 43 ZR 


62 96 60 
64 88 58 


70 CPU data section 
30 EXCP section 


0 18 Te 
64 STAT 

64 DSC 

64 STAT 

64 STAT 


26* 224 EO 
26** 264 108 


74 Device data section 
78 Subtype 1 1/0 queuing configuration data section 
78 Subtype 3 |/O queuing configuration data section 


74 Device data section 
79 Subtype 9 device data section 


26* 156 9C 
26** 196 C4 


26* 160 AO 
26** 200 C8 


26* 164 A4 
26** 204 CC 


26* 168 A& 
26** 208 DO 


6 PRNT 
6 PRNT 
6 PRNT 
50 34 22 (5735-RC2) 
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Record Offset Pa 





Field Description Type Dec.’ Hex. a 
Count of WRITE channel programs 50 30 1E (8734-RC2) — 
CPU identification 70 8 8 
CPU address 22 CPU 
CPU model number 22 CPU 
70 CPU control section 
CPU resource factor coefficient 72 17 11 
CPU serial number 70 CPU data section 
CPU service 4 REL 
5 REL 
30 Performance section 
34 REL 
35 REL 
CPU service definition coefficient 72 Workload control section 
CPU time 4 99 63 
4 ACT 
5 77 4D 
5 117 75 


30 Processor accounting section 
34 99 63 


34 ACT 
35 77 4D 
35 117 75 


CPU service coefficient 
CPU-Vector Facility indicator 


CPU wait time 


79 DDMWN section 
22 CPU section 
70 CPU data section 


= 
Cross memory address space indicator 79 106 6A ; 
Nw, aa 
Cross netowrk session 39 115 73 
CSA size 78 Common virtual storage section 
CSA usage 78 Common virtual storage section 
Cryptographic Unit Support 82 (5740-XY6) 
CKDS activity flags 82 KG 
function code 82 43 2B 
installation exit data 82 IDAT 
number of variable relocate sections 82 41 19 
options 82 CRYP 
return code 82 44 30 
Cylinder overflow areas that are full, 14 ISAM 
number of 15 ISAM 
Cylinders, number of unallocated 19 52 34 


69 48 30 





74 System Management Facilities (SMF) 














¢ *These records are for JES2. 
**These records are for JES3. 











Cylinders in independent index, 
prime data, and independent overflow 
areas, number of 


Cylinders in largest continuous 
unallocated area, number of 


‘Cylinders in largest unallocated 


extent, number of 
DAE COMMAND TIME/DATE 
DAE MEMBER OLD/NEW 


DASD volume status indicator 


Data checks to read text, number of 


Data format error indicators 
Data overruns, number of 


Data recording devices (DRDs) 





14 
15 


69 


19 


ISAM 
ISAM 


52 


56 


34 


38 


90 Set DATE/TOD section 
90 Set DATE/TOD section 


14 
15 


48* 
48** 
6** 
4g** 
22 


UCB 
UCB 


60 
68 


92 
69 
MSS 


3C 
28 


5C 
45 
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*These records are for JES2. 


**These records are for JESS. 


7-8 System Management Facilities (SMF) 


Record Offset 


Field Description 


a Type Dec. Hex. 





Data set, accepting VIO pages 


Data set control indicator 


Data set indicator 


Data set name 


Data set organization 


Data set record count 


Data set sequence count 

Data set sequence number 

Data set serial number 

Data sets open on device, total number of 


Data sets processed by writer, 
number of 


Data space extents, number of free 
Date, deadline schedule 

Date, JES3 allocation 

Date, JES3 device verification 


Date, logoff 


- Date, logon 


Date, logon enqueue 


Date “START SETUP command issued 


‘Date converter started 


Date converter stopped: 


Date execution processor started 


Date execution processor stopped 


Date fetch processing ended 


- Date all volume mount messages issued 


75 Page/Swap data set data sectior. 


79 PGSP data set section 


6 66 42 
14 42 2A 
14 55 37 
14 252 FC 
15 42 2A 
15 55 37 
15 252 FC 
17 44 2C 
18 44 2C 
18 88 58 
79 PAGESP section 
14 244 F4 
15 244 F4 


24 SYSOUT selection criteria section 


14 TAPU 
15 TAPU 
14 TAPU 
15 TAPU 
14 TAPD 
15 TAPD 


74 Device data section 


79 Subtype 9 device data section 


6 56 38 
69 46 2E 
26** 172 AC 
25** 80 50 
25** 88 58 
30 10 A 
35 10 A 
30 Identification section 
34 30 1E 
35 30 1E 
40 30 1E 


30 Identification section 
32 Identification section 
35 62 3E 


25 64 40 


26° 160 AO 
26** 200 C8 


26 168 As 
26** 208 DO 


26* 176 BO 
26*°* 216 D8 


26* 184 Bs 


26*°* 224 EO 
25** 56 38 
25°* 80 50 











Record Offset 








Field Description | Type Dec. Hex. 
Date initiator selected step/job 4 47 2F 
5. 47 2F 


30 Identification section 
32 Identification section 


Date, IPL 90 Self-defining section 
Date job terminated 5 10 A 
30 10 A 
35 10 A 
Date offload data set was allocated 24 General section 
Date output processor started 26* 192 CO 
26** 232 E8 
Date output processor stopped 26* 200 cs 
26** 240 FO 
Date output service started 6** 47 2F 
Date print/punch processor started 6* 47 2F 
Date reader recognized end of job 5 62 3E 


26* 152 98 
26** 192 co 
30 Identification section 


Date reader recognized the JOB card 4 30 1E 
amar d 30 1E 
6 30 1E 
10 30 1E 
14 30 1E 
.* 15 30 1E 
( 17 30 1E 
~ 18 30 1E 
20 30 1E 
25** 30 1E 
26 30 1E 
30 Identification section 
40 30 1E 
60 62 3E 
61 62 3E 
62 30 1E 
63 30 1E 
64 30 1E 
65 62 3E 
— «666 62 3E 
67 30 1E 
68 30 1E 
69 30 1E 
78 Subtype 2 (virtual storage) private area data section 
Date record was moved to dump 2 10 A 
data set 3 10 A 
Date record was moved to SMF buffer ALL! 10 A 
Date recording was started when 7 24 18 
SMF data set became available 
Date RMF measurement interval 70-79 14 E 
started | 
Date step terminated 4 10 A 
= 30 Identification section 
( *These records are for JES2. | 34 10 A 
ka **These records are for JES3. _-—2§©—S>=-_ Date transaction queued 59 Transaction type section 


' Except 2, 3 
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Field Description 


ARETE ETE TE TO EL PE IOI LP SETS A IE OATS TST TTS TEN TS SEE SA SE TIE OI, 


DCBOFLGS 
DCB=OPTCD=J 


DD DATA and DD* data set records 
read for step/job 


DD entry length 


DD name 


Deadline schedule date 

Deadline schedule time 

Deadline schedule type 

Deleted records, number of 
Density, tape 

Dependent job net identification 
Detail recording indicator 

Device active time 


Device allocation requests, number of 


Device busy 
Device busy delay 


Device class 


Device class code 
Device connect time 
Device disconnect time 


Device indicator 


Device name, logical input 
Device name, logical output 


Device name, transmitter 


Device number 





_ *These records are for JES2. 
**These records are for JES3. 


7-10 System Management Facilities (SMF) 


Record Offset ! 
Type Dec. Hex. +? 
21 42 2F 
6 PRNT 
4 51 33 
5 51 33 
30 1/O activity section 
14 52 34 
15 52 34 
14 56 38 
15 56 38 


26 136 88 
30 EXCP section 
64 DSC 


26** 172 AC 

26** 168 A8 

26** 124 7C 

64 STAT 

21 43 2B 

26** 160 AO 

90 Subsystem recording section 


74 Device data section 


1 4 54 36 

15 54 36 

74 Device section % 
74 Device data section Ne,” 
4 DEV 

5 73 49 

8 DEV 

9 DEV 

10 DEV 

11 DEV 

30 EXCP section 

34 DEV 

40 DEV 

74 6 6 


74 Device data section 


74 Device data section 


14 55 37 
14 252 FC 
15 55 37 
15 252 FC 
26 96 60 
6 72 48 
26* Network section 

57* 64 40 


4 Device section 
8 Device section 
oO imveere Te ay vt +7.e 
ww LIC VILG BVCULIVE! 


10 Device section 
11 Device section 

















Record Offset 

















*These records are for JES2. 
**These records are for JES3. 





Device pending time 
Device recording controls, MSF 


Device reserved samples, number of 


Device SSID 


Device type 


Devices, MSF data recording 


Devices requested during allocation, 
number of 


Device allocation start time 


DFSORT 
Cumulative value, SRB time 
Date ended processing 
Release/Level 
Return Code 
SRB Time 
TCB’s, number defined 
Triplets, number 


Disk volumes, number of 
requests for 


Disk volumes mounted by MDS, 
number of 


Dispatch position/priority 
DIV re-read counts 
DOB4J value 


Domain number 


Drive number 
DSCBs, number of 
DSCBOs, number of 


Dump data set, date record was 
moved to 


E-Frames 


Dump data set, time record was 
moved to 





Field Description Type Dec. Hex. 


14 UCB section 

15 UCB section 

19 64 40 

21 26 1A 

30 EXCP section 

34 Device section 

40 Device section 

64 EXT 

69 42 2A 

74 Device data section 

75 Page/Swap data set section 

79 Subtype 9 (DEV) device data section 
79 Subtype 11 (PGSP) data set section 


74 Device data section 
22 MSS 


74 Device data section 
79 Subtype 9 (DEV) device data section 


22 VAR 


74 Device control data section 
79 Subtype 11 (PGSP) data set section 


22 MSS 


14 54 36 
15 54 36 


4 90 5A 
30 Identification section 
34 90 5A 


16 104 68 
16 52 34 
16 10 A 
16 57 39 
16 108 6C 
16 112 70 
16 44 26 


25** 48 30 
25** 72 48 


79 Subtype 1 (ASD/ASDJ) data section 


30 28 1C 
90 SETDMN section 


79 ASRM/ASRMJ section 
90 SETDMWN section 


19 66 42 
19 46 2E 
19 48 30 


2 10 A 
3 10 A 
22 Extended storage section 
2 6 6 
3 6 6 
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_ 7 Record Offset or . 
Field Description Type Dec. Hex. Nee 


*These records are for JES2. 


**These records are for JESS. 


End-of-volume indicator 


Ending cylinder and track 


ENO 
address space identifier of job that 
issued ENO 


name of job that issued ENQ system 


system identifier of job that issued 
ENQ 


Enqueue status indicator 
Entries to the 1/O SLIH, number of 


Entry name 


Entry type indicator 


Equipment checks, number of 
Erase gaps, number of 


Errors, line 


Errors, number of temporary 
ERV resource manager coefficient 
Event records 

Event type 


Exception responses, number of 
EXCP count 


EXCP count for step 


Execution node name 

Execution processor (CPU) 
iaentit ication 

Execution processor start time and 
date 
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14 253 FD 
15 253 FD 


64 EXT 


79 Subtype 6 (SENQR) data section 


79 (SENOR) data section 
79 (SENOR) data section 


77 58 3A 
70 16 10 


60 120 78 
61 120 78 
63 92 5C 
65 120 78 
66 120 78 
67 88 58 
68 130 82 


60 119 77 
61 119 77 
63 42 2A 
63 43 2B 
65 119 77 
66 119 77 
67 88 58 
68 86 56 
68 130 82 


48** 67 43 
21 39 27 


48* 69 45 
48** 56 38 


53* Identification section 
72 20 14 

37 Event section 

37 Event section 


53* Identification section 


4 DEV 

14 UCB 

15 UCB 

30 EXCP section 
34 DEV 

40 DEV 

48 52 34 
64 STAT 


79 ARD/ARD4J section 
79 ARD/ARD4J section 


59 46 2E 
26* 228 E4 
26** 268 10C 


26* 172 AC 
26** 212 D4 








Record Offset 
Field Description Type Dec. Hex. 








Execution processor stop time and 
date 


Execution time, estimated 
Execution user id 
Exits, names of active 


Explicit route number 
Export Indicator 


Exposures for a multiple exposure 
device, number of | 


Extended storage frames 


Extents, number of 


Extents, number of unallocated 

Extents in independent index, prime 
data, and independent overflow 
areas, number of 


Extents released by DADSM routine, 
number of 


FCB image indentification 


( Feet of document printed, number of 
Fetch processing end date 
Fetch processing end time 


Fixed frames below 16 megabytes, 
average number of 


Fixed frames below 16 megabytes, 
maximum number of 


Fixed frames below 16 megabytes, 
minimum number of 


Fonts, number loaded 
Fonts, number used 


Form number 


FORMDEFS, number used 
Forms Overlay name 


Frames, 
Extended storage 
Min/max/avg CSA 


Min/max/avg LSQA 


( a | Min/max/avg LPA 


*These records are for JES2. 
**T hese records are for JES3. 





26" 180 B4 
26** 220 AC 


26 112 70 
59 54 36 
90 Subsystem recording section 


59 98 62 
36 212 D4 


74 Device control data section 


22 Extended storage section 


14 UCB 

15 UCB 

64 STAT 

19 60 3C 
14 ISAM 

15 ISAM 

14 DCB 

15 DCB 

6 80 50 


24 SYSOUT selection criteria section 


6* 64 40 
25** 56 38 
25** 562 34 
71 344 158 


71 340 154 


71 336 150 


6* 40 28 
6* 36 24 


6 57 39 

6* JES2 routing section 
26* 124 7C 
26* Print section 


6* 72 48 
6 PRNT 


22 see Extended storage section 
71 204 cC 


71 208 DO 

71 212 D4 

71 324 144 
71 328 148 
71 332 14C 
71 312 138 
71 316 13C 
71 320 140 
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*These records are for JES2. 


Field Description 


Min/max/avg in private 
address space 


Min/max/avg SQA 


Min/max/avg total 


number above or below the 
16-megabyte line 

Unused in nucleus 
Min/max/avg unused 


Function active time 
Function pending time 
Functional indicator 


FWKL vaiue 
GENKEY flags 


GENKEY key name 
GETMAIN limit 
Highest used relative byte address 


IEAICSxx member used 
old/new 


IEAIPSxx member 
IEAOPTxx member 


1/O processing method indicator 


1/O service 


1/O status 
IOP data status 
Impulse Hit Count 


Index levels, number of 


Integrated Catalog 
Facility Catalog Name 


Initial selection attempts, total 
number of 


Initialization deck origin 


Initiator select data for step/job 


Record Offset 
Type Dec. Hex. 
71 216 D8 
71 220 DC 
71 224 EO 
71 192 CO 
71 196 C4 
71 200 C8 
71 228 E4 
71 232 E8 
71 236 EC 


71 Paging data section 


71 140 8C 
71 84 54 
71 88 58 
71 92 5C 


79 Subtype 9 (DEV) device data section 

79 Subtype 9 (DEV) device data section 

40 43 2B 

90 SETDMN section 

82 GENK (5740-XY5, -XY6) 

82 GENK 

78 Subtype 2 (virtual storage) area data section 
64 134 86 


72 Workload control section 

72 Workload contro! section 

79 Subtype 8 (TRX) data section 
90 IPL SRM section 

90 SET ICS section 


79 Subtype 8 (TRX) data section 


72 Workload control section 
72 96 60 


14 253 FD 
15 253 FD 


4 REL 

5 REL 

30 Performance section 
34 REL 

35 REL 

6 55 37 

78 Subtype 3 IOP initiative queue section 
37 10 A 
14 ISAM 

15 ISAM 

64 STAT 

36 88 58 


78 Subtype 1 !/O queuing data section 


43** 29 1D 


4 47 2F 
5 47 2F 
30 Identification section 
32 Identification section 





**These records are for JESS. 
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*These records are for JES2. 
**T hese records are for JESS. 


Field Definition 





Initiator select time for step/job 


Initiator Vector Facility affinity time 
Initiator Vector Facility usage time 


Input cards for job, number of 


Input class for job 
Input processor (CPU) identification 


Input route code 

Input/output (see |/O) 

Inserted records, number of 
Intelligience controller name 
Interventions required, number of 
1/O service definition coefficient 
IOC resource factor coefficient 


IOC service definition coefficient 


IPL reason 
IPS name 


JES selection priority 


JES job number 


JES2 completion code 


JES2 identification 


JES2 job selection priority 


JES2 logical input device name 
JES2 logical output device name 


JES2 output selection priority 


JES2 start options 


JES2 termination indicator 


Record Offset 
Type Dec. Hex. 
4 43 2B 
5 43 2B 


30 Identification section 
32 Identification section 


34 43 2B 

30 32 20 

30 24 18 

26* 208 DO 
26** 248 F8 

5 75 48 

30 Identification section 
26* 220 DC 
26** 260 104. 
26* 94 5E 

64 STAT 

50 18  12(5735-RC2) 
48** 65 41 


79 Subtype 10 (DOMN) data section 
72 Workload control section 


72 Workload control section 
90 IPL PROMPT section 


90 IPS section 


5 57 39 
26 90 5A 
26 91 5B 


30 Identification section 
32 Identification section 


35 59 3B 
6 68 44 
26 56 38 


30 Identification section 
32 Identification section 


45 26 1A 

6* 62 3E 
24 18 12 
26* 46 2E 
43* 18 12 
45* 18 12 
47* 18 12 


48* 18 12 
49* 18 12 


26* 90 5A 
26* 91 5B 
26* 96 60 
6* 72 48 
26* 92 5C 
26* 93 5D 
43* 27 1B 
45* 24 18 
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*These records are for JES2. 





JES3 allocation completion date 
JES3 allocation completion time 
JES3 completion code 

JES3 device verification date 
JES3 device verification time 
JES3 identification 


JES3 initialization deck origin 
location 


JES3 initialization deck origin type 
JES3 job selection priority 


JES3 logical input device group name 
JES3 logical input device name 

JES3 logical output device group name 
JES3 logical output device name 

JES3 procedure name 

JES3 start options 

JES3 termination indicator 


JES3-assigned job number 
JFCB 

FJCB TTR address 

Job 


origin 


Job accounting fields 


Job class 


Job class name 


Job completion code 


Job CPU time 
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30 Identification section 
32 Identification section 


25** 
25** 
45** 
25* * 
25** 
6* 

26** 
43** 
45** 
47** 
4g** 
4g** 


4g** 


43** 


26°" 
26* * 


26** 
26** 
26** 
26** 
43** 
43** 
45** 


6** 
26* * 


14 
15 


14 
15 


57** 
5 


80 
76 
25 
88 


29 


90 
91 


128 
96 
96 
72 
38 
26 
24 


68 
56 


68 
68 


64 
64 


106 
121 


Record Offset 

Field Description Type Dec. Hex. 
- JES2-assigned job number 6* 68 44 
26* 56 38 


50 
4C 
19 
58 


1D 


5A 
5B 


80 
60 
60 
48 
26 
1A 
18 


44 
38 


44 
44 


40 
40 


6A 
79 


26 Network section 
30 Accounting section 


35 
5 


30 Identification section 
24 Job selection criteria section 


26 89 59 
26** 176 BO 

5 55 37 
30 Completion section 
35 55 37 

5 77 4D 

5 117 75 
30 Processor accounting 
35 77 4D 
35 117 75 


121 
75 


79 
4B 








Ne 








*These records are for JES2. 


**T hese records are for JESS. 





Field Description 


Record Offset 
Type Dec. Hex. 





Job identification 
current 


original 


Job information indicator 


Job log identification 


Job name 





26 60 3C 
24 General section 
26 60 3C 
57** 24 18 
24 General section 
57** 24 18 
26 54 36 
4 18 12 
5 18 12 
6 18 12 
10 18 12 
14 18 12 
15 18 12 
17 18 12 
18 18 12 
20 18 12 


24 General section 


25°" 18 12 
26 18 12 
30 Identification section 
40 18 12 
60 50 33 
61 50 33 
62 18 12 
63 18 12 
64 18 12 
65 50 33 
66 50 33 
67 18 12 
68 18 12 
69 18 12 


_ 78 Subtype 2 (virtual storage) private area data section 


4 18 12 
5 18 12 
6 18 12 
10 18 12 
14 18 12 
15 13 12 
17 18 12 
18 18 12 
20 18 12 


25** 18 12 

26 18 12 

30 Identification section 

32 Identification section 

34 18 12 

35 18 12 

40 18 12 

57** 34 22 

60 50 32 

61 50 32 

62 18 12 

63 18 12 

64 18 12 

65 50 32 

66 50 32 

67 18 12 

68 18 12 

69 18 12 

78 Subtype 2 (virtual storage) private area data section 
82 24 18 | — 
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*These records are for JES2. 
**These records are for JES3. 


Field Description 


Job Number 


current 
Original 
Job print copy count 
Job print route code 


Job priority 


Job selection priority 


Job performance group number 


Job punch route code 


Job service 


Job/step Vector Facility affinity time 
Job/step Vector Facility usage time 


Job termination date 


Job termination indicator 


Job termination time 


Job transaction active time 


Job transaction residency time 


Job transmitter 
Start/stop time 
Start/stop date 


Job type indicator 
Juv wait time limit 


JWT parameter 


Key, storage protect 


Key length 
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Record Offset 


Type Dec, Hex. 


6 68 44 
26 56 38 
30 Identification section 
32 Identification section 


57** 42 2A 
57** 46 26 
26* 128 80 
26* 132 84 


5 57 39 
30 Processor accounting section 
35 57 39 


26 90 5A 


26 91 5B 
4 REL 
5 92 5C 


30 Identification section 
32 Identification section 
34 REL 

35 92 5C 


26* 134 86 


5 80 50 
30 Performance section 
35 80 50 


30 28 1C 
30 20 14 


5 10 A 
30 10 A 
35 10 A 
5 66 42 


30 Completion section 
35 66 42 


5 6 6 
30 6 6 
35 6 6 
5 84 54 


30 Performance section 
35 84 54 


6 
30 Performance section 
35 68 44 


26* Network section 
26* Network section 


57** 28 2C 


0 18 12 
0 18 12 
90 SMF command section 
4 86 56 
5 76 4C 


30 Storage and paging section 
34 86 56 
35 76 4C 


64 DSC 


a 

















*These records are for JES2. 


**T hese records are for JES3. 





Field Description 


Length of accounting and availability 
data sections 


Length of Data Section 
Length of DD entry 


Length of 1/O activity section 
Length of LPDA-2 section 
Length of LAN section 


Length of measurable interval 
Length of product section 
Length of object ACCESS data section 


Length of object 
UNACCESS data section 


Length of securing header 


Limit, continuous wait time 
Line adapter number 
Line errors 


Line name 


Line quality 
Lines, Output, number of 


Lines, terminal input, number of 


Lines, terminal output, number of 


Lines generated to spool, number of 
Lines, password 


Lines per page, number of 
Lines, VTAM requests processed 


Link pack area page-ins 


Link pack area reclaims 


Link Segment Level 


Local Modem Report 





Record Offset 
Type Dec. Hex. 


39 36 24 
36 40 28 
14 52 34 
15 52 34 
41 56 38 
37 66 42 
37 74 4A 


23 System section 
90 Subsystem recording section 


39 44 27 
41 32 20 
41 40 28 
41 48 30 
82 18 12 
0 18 12 


90 SMF command section 


48* 72 48 
48** 80 50 


48* 68 44 
48** 56 38 


47 36 24 
48 36 24 
49 36 24 
52* Identification section 
53* Identification section 
55* 34 22 
56* 34 22 
58* Identification section 


37 6 6 
26 116 74 
34 51 33 


30 1/0 activity section 
35 51 33 


34 47 2F 
30 1/O activity section 
35 47 2F 


26* 212 D4 
26** 252 FC 


52* Identification section 
53* Identification section 


26* 130 +82 


53* Identification section 


4 REL 

30 Storage and paging section 
34 REL 

4 REL 

30 Storage and paging section 
34 REL 

37 3 3 


37 8 8 
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a 3 
*These records are for JES2. 


**These records are for JES3. 








Field Description 
Local page data set slots 


min/max/avg allocated to 
non-VIO private area 


min/max/avg allocated to 
VIO private area 


min/max/avg unallocated 
min/max/avg unusable 


Logical record size, maximum 
Logical record, TP 
Logical records, number written 


Logical records in overflow and prime 
data areas, number of 
Logoff date 


Logoff time 


Logon date 


Logon enqueue date 
Logon enqueue time 
Logon priority 


Logon time 


Lost dates, number of 


Lowest page address in real 
continuous storage 


LPA page-ins 
LPA reclaims 


LPA size 
LSQA storage usage 


LU name 


MAC address, downstream 


MAC address, upstream 
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Record Offset 


Type Dec. Hex. 


71 204 CC 
71 208 DO 
71 212 D4 


71 192 CO 
71 196 C4 
71 200 C8 

288 120 
71 180 B4 
71 184 BS 
71 188 BC 
71 216 D8 


71 220 DC 
71 224 EO 


64 DSC 

57* 100 64 
6 51 33 
14 ISAM 

15 ISAM 

30 10 A 
35 10 A 
30 6 6 
35 6 6 


30 Identification section 
34 30 1E 
35 30 1E 
40 30 1E 


30 Identification section 
35 62 3E 


30 Identification section 
35 58 3A 


30 Identification section 
35 57 39 


30 Identification section 
34 26 1A 
35 26 1A 
40 26 1A 


48** 70 46 


22 STOR 

4 REL 

30 Storage section 
34 REL 

4 REL 

30 Storage section 
34 REL 


78 Common virtual storage section 


78 Private virtual storage section 


47** 36 24 
48** 36 24 
48** 36 24 


37 36 24 
37 30 1E 











 * Record Offset 
7 Field Description Type Dec. Hex. 








Macro instruction and option types 


Main storage service 


Main storage service definition 
coefficient 


MAXDORM value 


Maximum input block size 


Maximum logical record size 


Measurement interval, RMF 
date started 
duration 


Message class 


Message text 


Model number, channel 
Model number, CPU 
Modem address 

Modem Model 

Modem Sense Byte 
Modem Speed 

Modem Type 

Module identification 


MPL value 


MSF data recording devices 
MSF device recording controls 
MSF indicator 

MSO service coefficient 

MSS volume requests 


MVS/BDT, 
destination file name 
job number 
node name 
origin file node 
PDS member name of 
destination file 
transaction queuing node 
transaction source node 
transaction source processor name 


14 247° ~#«#£F7 


14 ISAM 

15 247 F7 

15 ISAM 

4 REL 

5 REL 

30 Performance section 
34 REL 

35 REL 


72 34 22 


90 SMF command section 


16 Data section 


64 DSC 


70-79 14 E 
70-79 18 12 


26 88 58 


47 54 36 
49 54 36 


22 CHAN 

22 CPU 

37 Modem section 

37 4 0 
37 2 2 
37 16 10 
37 0 0 


19 66 42 


90 SETDMN section 
79 DDMWN section 


22 MSS 
22 MSS 
22 MSS 


79 DDMN section 
25** 92 5C 


59 Transaction type section 

59 Transaction identifier section 
59 Product section 

59 Transaction type section 


59 Transaction type section 

59 Transaction identifier section 
59 Transaction identifier section 
59 Transaction identifier section 





*These records are for JES2. 


**These records are for JES3. Chapter 7, Field-to-Record Cross-Reference 7-21 





**These records are for JES3. 





Field Description 


MVS software level 


Name of catalog 


Name of component or cluster 


Name of data set 


Name of device, logical 


Name of entry 


Name of exits 
Name of IPS 


Name of job 
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Record Offset —_, 
— Type Dec. Hex. a Y 
70 40 28 
71 40 28 


72 40 28 
73 40 28 
74 40 28 
75 40 28 
76 40 28 
77 40 28 
78 40 28 
79 40 28 


61 75 4B 
62 46 2E 
63 48 30 
64 44 2C 
65 75 48 
66 75 48 
67 44 2C 
68 42 2A 
69 66 34 


62 96 60 
64 88 58 
17 44 2C 
18 44 2C 
18 88 58 


6 72 48 
26 96 60 


60 120 78 
61 120 78 i 
63 92 5C oY 
65 120 78 _ 
66 120 78 

67 88 58 

68 86 56 

68 130 ~=82 


90 Subsystem recording section 
72 56 38 


4 18 12 
5 18 12 
6 18 12 


10 18 | 12 

14 18 12 

15 18 12 

17 18 12 

18 18 12 

20 18 12 
25** 18 12 
26. =—-' 18 12 

30 Identification section 
32 Identification section 
34 18 12 

35 18 12 

40 18 12 

59 Transaction data section 
60 50 32 

61 50 32 

62 18 12 

63 18 12 

64 18 12 

















Record Offset 
Field Description Type Dec. Hex. 








65 50 32 
66 50 12 
67 18 12 
68 18 12 
69 18 12 
78 Private virtual storage section 
82 24 18 


Name of job class 26** 176 80 


Name of line 47 36 24 
48 36 24 
49 36 24 


Name of LU 47** 36 24 
48*°* 36 24 
49** 36 24 
Name of program 4 58 3A 
30 Identification section 
34 58 3A 
78 Private virtual storage section 
Name of programmer 5 97 61 
20 44 26 
26 68 44 
59 Transaction data section 
Name of remote device 47 28 1c 
48 28 1C 
&9 28 1c 
aan Name of step 4 66 42 
( 30 Identification section 
34 66 42 
78 Private virtual storage section 
82 32 20 
Name of system, if NJP 26** 96 60 


26*°* 144 90 
26°* 152 98 


Name of VSAM Volume data set 60 76 48 
Name of work station 47°* 28 1Cc 
48*°* 28 1C 
49°* 28 1C 
Name of work station 47** 28 1C 
4g** 28 1c 
49** 28 1C 
NCP entered slowdown, number 50 58 3A 
of times 
Negative acknowledgements to 48* 56 38 
write text, number of 48** 62 3E 
Negative response count, RECEIVE 4g*°* 62 3E 
Negative response count, SEND 48** 60 3C 
Network accounting number 26* Network section 
57** 74 4A 
New catalog record 61 208 DO 


63 136 88 
65 208 DO 
66 208 DO 
67 134 86 





EF EAE PRE BEST ES EE 
*These records are for JES2 only. 
**These records are for JES3 only. 
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New catalog record size 63 44 2C 2 nes 
| 67 132 84 We 
New data set name 18 88 58 
New entry name 66 164 A4 ‘ 
68 130 82 
New VSAM Volume Record 60 208 D0 
Node name 26** Network section 
55° 24 18 
56° 24 18 
58* 24 18 
59 Product section 
executing 57° 48 30 
57** 122 7A 
destination 57** 138 8A 
next | 57* 40 28 
original 24 General section 
57* 40 28 
Noise biocks, number of 21 38 26 
Non-VIO, non-swap page-ins 4 REL 
30 Storage and paging section 
34 REL 





SE a eR EL ET 
*These records are for JES2 only. 
**These records are for JES3 only. 
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Record Offset 





C 


**These records are for JES3. 


*These records are for JES2. 


Non-V10O, non-swap page-outs 


Non-V1IO page reclaims 
Notify user id (NJHGUSID) 


NPA, 
Event records 
Event type 
Modem address 
Release level 
Resource name, failure 
Resource type, failure 


Nucleus size 


Number of accounting and availability 
data sections 


Number of address space swap 
sequences 


Number of address space swap 
sequences 


Number of blocks per volume 


Number of buffers allowed per 
terminal before LWAIT 


Number of buffers allowed per 
terminal before OWAIT 


Number of buffers reserved on 
free queue 


Number of buffers 
written 
minimum/maximum 


Number of bus-out checks 
Number of bytes in real storage 
Number of bytes in SMF buffer 
Number of bytes in virtual storage 
Number of bytes sorted 


Number of cards, input 


Number of cards, output punched 


Number of cards generated to spool 


Number of card-image records in DD 
DATA and DD* data sets read for 
step/job 


Number of cleaner actions 
Number of command rejects 


Number of copies printed 





Field Description Type Dec. Hex. 


4 REL 
30 Storage and paging section 


30 Storage and paging section 
59 30 1E 


37 Event section 
37 Event section 
37 Event section 
37 Event section 
37 Event section 
37 Event section 


78 Common virtual storage section 


39 38 26 

4 REL 

30 Storage and paging section 
34 REL 

79 SRCS Data section 

4 REL 

30 Storage and paging section 
34 REL 

79 SRCS Data section 

14 TAPD 

15 TAPD 

31 26 1A 

31 24 18 

31 32 20 


23 Statistics section 
90 SMF command section 


48** 66 42 


0 31 1F 
0 22 16 
0 26 1A 


16 Data section 


26* 208 DO 
26** 248 F8 


26 120 78 


26* 216 D8 
26** 256 100 


4 51 33 

5 51 33 
30 1/0 activity section 
21 41 29 
48** 64 40 

6 PRNT 
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aN a a eg eat eee 
*These records are for JES2. 


**These records are for JES3. 


Field Description 


Number of control bytes sent from 
primary to secondary 


Number of control bytes sent from 
secondary to primary 


Number of control P!IUs sent from 
primary to secondary 


Number of control P!IlUs sent from 
secondary to primary 


Number of cylinders in independent 
index, prime data, and independent 
overflow areas 


Number of cylinders in largest 
continuous unallocated area 


Number of cylinders in largest 
unallocated extent 


Number of data checks to read text 


Number of data overruns 


Number of data sets 
open 
requested 


Number of data set sequences 


Number of data sets processed by 
writer 


Number of devices requested during 
allocation 


Number of disk volumes requested 


Number of disk volumes mounted 
by MDS 


Number of DSCBs 
Number of DSCBOs 


Number of E-frames 
available 
installed 


Number of enqueued requests 
Number of entries on CU-HDR queue 
Number of equipment checks 
Number of erase gaps 

Number of EXCPs 


oa oe od 


Number of EXCP for address spaces 
Number of exposures for a multiple 
exposure device 


Number of extents 
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Record Offset oN 
Type Dec. Hex. 


eX 
i 
y 


3924 68 
394 18 
39 «20 14 
39 «28 1C 
14. ISAM 

15 ISAM 

69 «82 34 
19 «66 38 


48* 60 3C 
48** 68 44 


48** 69 45 


79 DEV section 
75 144 90 


14.“ TAPU 
15. TAPU 
6 56 —s-38 
as 
14 54 36 os 


15 54 36 es 
25** 48 30 
25** 72 48 


19 46 2E 
19 48 30 


70 Paging data section 
79 Subtype 1 (ASD and ASDJ) data section 
79 Subtype 1 (ASD and ASDJ) data section 


79 CHANNEL section 
79 Subtype 14 1/O queuing section 
48** 69 45 


21 39 27 
4 DEV 

14 UCB 

15 UCB 

30 EXCP section 
34 DEV 

40 DEV 

48 52 34 
64 STAT 








14 UCB | 40 
15 UCB | seal | 
16 70 46 

64 STAT 








Record Offset 
Type Dec. Hex. 





Field Description 








*These records are for JES2. 


**These records are for JES3. 


Number of extents in independent 
index, prime data, and independent 
overflow areas 


Number of extents released by DADSM 
routine 


Number of feet of document printed 
Number of fonts loaded 

Number of fonts used 

Number of FORMDEFS used 


Number of 4k frames in this 
contiguous block 


Number of frames 
available 


common pageable and fixed 
common/private fixed 
LPA/CSA fixed 

LPA/CSA pageable 
LSQA/non-LSQA fixed 


SOA 
Number of free data space extents 


Number of full cylinder overflow areas 


Number of full SMF buffers 
Number of inbound PIUs 
Number of interventions requried 


Number of !/O requests for a data set 


Number of LAN sections 


Number of line errors 


Number of lines per page 


Number of logical records in overflow 
and prime data areas 


Number of logical records written 
Number of lost datas 
Number of LPDA-2 sections 


Number of negative acknowledgements 
to write text 


Number of negative acknowledgements 
to write text 


Number of noise blocks 

Number of non-specific DASD mounts 
Number of non-specific tape mounts 
Number of non-specific MSS mounts 


Number of non-VIO, non-swap page-ins 








14 ISAM 
15 ISAM 
14 DCB 
15 DCB 


6* 64 40 
6* 40 28 
6* 36 24 
6* 72 48 


22 Extended storage section 


71 Paging data section 
79 SPAG section 

79 SRCS section 

79 SRCS section 

79 SRCA section 

79 SRCS section 

79 SRCS section 

79 ARD/ARD4J section 
79 SRCS section 


79 SRCS section 

69 46 2E 

14 ISAM 

15 ISAM 

23 Statistics section 

50 44 2C (5735-RC2) 


48** 65 41 


75 Page/Swap data set data section 
79 Subtype 11 (PGSP) data set section 


37 76 4C 
4g* 68 44 
4g** 56 38 
26* 130 82 
14 ISAM 

15 ISAM 

6 51 33 
4g** 70 46 
37 68 44 
48* 56 38 
4g** 62 3E 


48* 56 38 
48** 62 3E 


21 38 26 
30 Operator section 
30 Operator section 


30 Operator section 


4 REL 
30 Storage and paging section 
34 REL 
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*These records are for JES2. 
**These records are for JESS. 





Field Dsscription 


Number of non-V1O, non-swap 
page-outs 


Number of non-V1O page reclaims 


Number of object ACCESS data sections 


Number of object UNACCESS 
data sections 
Number of outbound PIUs 


Number of output lines 


Number of output lines generated 
to spool 


Number of output punched cards 
Number of overlays loaded 
Number of overlays used 


Number of page seconds 


Number of page segments loaded 


Number of page segments used 
Number of PAGEDEFS 
Number of pages-current transaction 


Number of pages in real contiguous 
storage 


Number of pages moved to frames 
above or below the 16-megabyte line 


Number of pages printed 


Number of pages stolen 


Number of pages swapped in 


Number of pages swapped out 


Number of pages transferred 


Number of permanent read errors 


Number of permanent write errors 
Number of product sections 


Number of read or write accesses to an 
overflow record 


Number of read buffers used 


Number of reclaims 


Number of records deleted, inserted, 


wae wre ee ee 


updated, and retrieved from 
component 


Number of records in component 


Number of records lost 
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Record Offset 

Type Dec. Hex. 
4 REL 
30 Storage and paging section 
34 REL 
30 Storage and paging section 
41 42 2A 
41 50 32 
50 50 32 (5735-RC2) 
26 116 46 
26* 212 D4 
26** 252 FC 
26 120 78 
6* 48 30 
6* 44 2C 
4 REL 
30 Storage and paging section 
34 REL 
6* 56 38 
6* 52 34 
6* 68 44 


79 Subtype 2 (ARD/ARDJ) data section 


22 


STOR 


71 Paging data section 


58 


30 Storage and paging section 


30 Storage and paging section 


30 Storage and paging section 


6 88 

4 REL 
34 REL 
4 REL 
34 REL 
4 REL 
34 REL 
75 152 
79 PGSP section 
21 36 

21 37 

41 34 

14 ISAM 
15 ISAM 
50 52 

4 REL 
34 REL 
64 STAT 
64 STAT 
7 18 


98 


24 
25 


22 


34 (5735-RC2) 


12 

















*These records are for JES2. 


**These records are for JESS. 


tee 





Field Description 
Number of records sorted 


Number of records transmitted 
or received 


Number of response-time 
data sections 


Number of route data sections 


Number of samples 


Number of samples in an interval 


Number of samples indicating that 
the control unit is busy 


Number of samples indicating that 
the data set is being used by ASM 


Number of samples indicating a delay 
because a loosely-coupied processor 
reserved the device 


Number of samples indicating that the 
device was allocated 


Number of sample indicating that the 
device was busy while the control 
was not 


Number of samples indicating that the 
device was not ready 


Number of samples indicating that the 
device was reserved 


Number of samples indicating that the 
physical channel was in burst mode 


Number of samples indicating that the 
physical channel was in a wait state 


Number of session configuration 
sections 


Number of slots 
bad 
total 


used, min/max 


unused 
Number of SMF records written 
Number of split control areas 
Number of split control intervals 
Number of SSCHs 














Record Offset 


Type Dec. Hex. 
16 Data section 


24 General section 
39 20 1E 


39 22 16 


70 Product section 

71 Product section 

73 Product section 

74 Product section 

75 Product section 

76 Product section 

78 Product section 

78 Subtype 2 (virtual storage) private area data section 
79 Subtype 9 (DEV) device data section 


79 Subtype 9 (DEV) device data section 
79 Subtype 9 (DEV) device data section 


75 140 8C 
79 PGSP section 


74 Device section 


74 Device section 
79 DEV section 


79 DEV section 


74 Device section 


74 Device section 


79 CHANNEL section 


79 CHANNEL section 


39 14 E 


79 DDMWN section 
75 120 78 
79 PGSP section 

75 124 7C 
75 128 80 
79 PGSP section 

75 136 88 


23 Statistics section 
64 STAT 
64 STAT 


21 34 22 
74 16 10 
79 16 10 
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*These records are for JES2. 


**These records are for JESS. 





Field Description 


Number of step 


Number of steps in job 


Number of swap candidates 
Number of swap-ins 


Number of swap sequences 


Number of swaps migrated from 
extended storage 


Number of specific DASD mounts 
Number of specific MSS mounts 
Number of specific tape mounts 
Number of tape volumes requested 


Number of tape volumes mounted 
by MDS 


Number of temporary read errors 
Number of temporary write errors 


Number of terminal input lines 


Number of terminal output lines 


Number of text bytes sent from 
primary to secondary 


Number of text bytes sent from 
secondary to primary 


Number of text P!Us sent from 
primary to secondary 


Number of text PIUs sent from 
secondary to primary 


Number of TGETs 


Number of times NCP entered 
slowdown 


Number of time-outs to read text 


Number of time-sharing buffers 


Number of TPUTs 
Number of tracks allocated on device 


Number of tracks in largest 
unallocated extent 


Number of tracks in largest continuous 
unallocated area 


Number of tracks in overflow area 
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Record Offset 
Type Dec. Hex. 
4 42 2A 


30 Identification section 
34 42 2A 
40 42 2A 
5 42 2A 


30 Identification section 
35 42 2A 


70 Swap placement section 
79 SPAG section 


4 REL 
30 Storage and paging section 
34 REL 


70 Swap placement section 


30 Operator section 
30 Operator section 
30 Operator section 
25** 44 2C 
25** 68 44 


21 32 20 
21 33 21 


30 I/O activity section 
34 51 33 
35 51 33 


30 1/0 activity section 
34 47 2F 
35 47 2F 


39 40 28 
39 48 30 
39 36 24 
39 44 2C 


30 I/O activity section 
32 TSO command section 


50 58 3A 


48* 64 40 
48** 60 3C 


31 18 12 


30 |/O activity section 
32 TSO command section 


14 UCB 
15 UCB 


19 58 3A 


69 54 36 


14 ISAM 
15 ISAM 

















*These records are for JES2. 
**These records are for JES3. 





Field Description 





Record Offset 
Type Dec. Hex. 





Number of tracks released by DADSM 
routine 


Number of tracks requested but not 
allocated 


Number of tracks used by sort 


Number of transactions 


Number of triplets 


supported by DFSORT 


Number of TSO commands 


Number of unallocated cylinders 


Number of unallocated extents 


Number of unallocated tracks 


Number of unused alternate tracks 
Number of unused control intervals 


Number of VIO and non-V1IO pages 
for current transaction 


Number of VIO page reclaims 


Number of VIO page-ins 


Number of VIO page-outs 


Number of volumes 


Number of work data sets used 


Number of work data sets used 


Object size when ACCESSed 
(units of blocks) 


Object size when UNACCESSed 
(hundreths of a second) 


Object type (1=DA) 

Offset of 1/O activity section 
Offset to LPDA-2 section 
Offset to LAN section 


Offset to object ACCESS data section 


Offset to object UNACCESS 
data section 


Offset to data section 


Offset to product section 


Offload data set name 


Old catalog record 








14 DCB 
15 DCB 


64 132 84 


16 Data section 


30 Performance section 
35 88 58 
39 24 18 


36 24 18 
41 24 18 
16 44 2C 


32 Command section 


19 52 34 
69 48 30 


19 60 3C 


19 54 36 
69 50 32 


19 50 32 
64 STAT 
79 Subtype 2 (ARD/ARDJ) data section 


30 Storage and paging section 


4 REL 
30 Storage and paging section 
34 REL 
4 REL 
30 Storage and paging section 
34 REL 


17 91 5B 
18 135 53 
62 140 58 


16 Data section 


16 Data section 
41 Object ACCESS Section 


41 Object UNACCESS Section 


41 Object ACCESS Section 
41 52 34 


37 62 3E 
37 70 46 
41 36 24 
41 48 30 


36 36 24 


36 28 1C 
41 28 1C 


24 General section 


63 136 54 
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Record Offset 4 


Field Description Type Dec. Hex. 
Old catalog record size 63 46 2E 
Old data set name 18 44 2C 
Old entry name 66 120° 78 
68 86 56 
OPEN routine indicator 14 249 FO 
15 249 F9 
Open status indicator 62 42 2A 
Operating system release level 23 System section 
Operators name 90 IPL PROMPT section 
OPT member used 90 IPL SRM section 
old/new 90 SET OPT section 
OPTCD=J 6 PRNT 
Options, SMF 0 30 1E 
90 SMF section 
Original job name (NJHGJNAM) 59 14 E 
Original job number (NJHGJID) 59 2 2 
Output form number 26* 124 4E 
Output lines, number of 26 116 74 
Ouptut lines generated to spool, 26* 212 D4 
_ number of 26** 250 100 
Output priority 6** 94 5E 
Output processor (CPU) identification 26* 232 E8 Bee 
26** 272 110 
Output processor start time and date 26* 188 BC eae 
26** 228 E4 
Output processor stop time and date 26* 196 C4 
26** 236 EC 
Output punched cards, number of 26 120 78 
_ Output selection priority | 24 SYSOUT selection criteria section 
Overlay name 6 PRNT 
Overlays, number loaded 6 48 30 
Overlays, number used 6 44 2C 
OWAIT threshold 31 28 1C 
Owner identification of direct access 19 26 1A 
volume 
Page count, printed 
actual 26* Print section 
estimated 26* Print section 
Page data set slots 
allocated to VIO 71 128 80 
allocated to non-VIO 71 132 84 
total number 71 124 7C 
unallocated 71 136 88 
Page movement rate, total 71 348 15C 
Page reclaims, LPA 4 REL 
30 Storage and paging section 
34 REL 
71 88 58 
Page reclaims, non-VIO, non-swap 71 64 40 





*These records are for JES2. 
**These records are for JESS. 
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*These records are for JES2. 
**T hese records are for JES3. 


Field Description 


Page seconds 
Page segments, number loaded 
Page segments, number used 


PAGEDEEFS, number used 
Page-ins, LPA 


Page-ins, non-VIO, non-swap 


Page-ins, VIO 


Page-outs, non-VIO, non-swap 


Page-outs, VIO 


Pages, number in real contiguous 
storage 


Pages, number moved to frames above 
or below the 16-megabyte line 


Pages, number of printed 
Pages, stolen 


Pages swapped in, number of 


Pages swapped out, number of 


Password 


Performance class name 


Performance group number 








Record Offset 
Type Dec. Hex. 


4 REL 

30 Storage and paging section 
34 REL 

6 56 38 

6 52 34 

6 68 44 

4 REL 

30 Storage and paging section 
34 REL 

71 104 68 

4 REL 

30 Storage and paging section 
34 REL 

71 56 38 

4 REL 

30 Storage and paging section 
34 REL 

71 Paging data section 

4 REL 

30 Storage and paging section 
34 REL 

71 Paging data section 

4 REL 

30 Storage and paging section 
34 REL 

71 Paging data section 

22 STOR 


71 Paging data section 


6 88 58 

30 Storage and paging section 
4 REL 

30 Storage and paging section 
34 REL 

71 Paging data section 

4 REL | 

30 Storage and paging section 
34 REL 

71 76 4C 


47 44 2C 
48 44 2C 
49 44 2C 
54* Identification section 
55* 34 22 
55* 42 2A 
56* 34 22 
56* 42 2A 


39 82 52 


4 REL 

5 92 5C 

30 Identification section 
32 Identification section 
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Record Offset ff os 





Field Description Type Dec. Hex. Ne 2 
Performance group number (continued) 34 REL 
35 92 5C 
79 Subtype 3 (ARD/ARDJ) data section 
79 Subtype 3 (ASD/ASDJ) data section 
79 Subtype 5 (ASRM/ASRMJ) data section 
79 Subtype 8 (TRX) data section 
Performance group number, highest 
defined in IPS 
Permanent read errors, number of 21 36 24 
Permanent write errors, number of 21 37 25 
PG number, highest defined in 72 4 4 
IPS or ICS 
Physical unit (PU) name for SLU 39 50 32 
PLU domain name 39 34 22 
PIUs, number inbound 50 46 2E (5735-RC2) 
PIUs, number outbound 50 50 32 (5735-RC2) 
PLU subarea physical unit (PU) 39 26 1A 
Portable Data Set Name 36 158 9E 
Portable Data Set Volume 36 202 CA 
Positive response count, RECEIVE 48** 66 42 
Positive response count, SEND 48** 64 40 
Print copy count, job 26* 128 80 
Print route code, job 26* 132 84 —_— 
Print/punch processor start time 6* 43 2B Me? 
Printed byte count 
actual 26 Print section 
estimated 26 Print section 


Printed page count 


actual 26 Print section 
estimated 26 Print section 
Priority, address space dispatching 4 57 39 


30 Processor section 
34 57 39 





Priority, job 5 57 39 
30 Identification section 
35 57 39 
Priority, job selection 26 90 5A 
26 91 5B 
Priority, logon 30 Identification section 
35 57 39 
Priority, output selection G** 94 5E 


24 SYSOUT selection criteria 
26* 92 5C 
26* 93 5D 








Primary link name 39 18 12 
Primary logical unit (PLU) name 39 2 2 
Primary physical unit (PU) name 39 10 A 
Private area, storage used from 4 78 4E 
bottom of 30 Storage and paging section 
*The d =S$2. _* 
sap Eee reese 78 Private virtual storage section 
These records are for JES3. ; 
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*These records are for JES2. 


**These records are for JESS.. 











Record Offset 
Field Description Type Dec. Hex. 
Private area, storage used from top of 4 76 4C 


30 Storage and paging section 
34 76 4C 
78 Private virtual storage section 


Private area size in bytes, below and 30 Storage and paging section 

above 16 megabytes 78 Common virtual storage section 
78 Private virtual storage section 

Procedure DDNAME 26 136 88 

Procedure name, JES3 43** 38 26 

Processor time used by sort 16 Data section 

Product name 30 Product section 


32 Product section 
90 Product section 
41 Product section 


Program name 4 58 3A 
30 Identification section 
34 58 3A 
78 Private virtual storage section 
Program start time 4 94 5E 
34 94 5E 
Programmed Cryptographic Facility 82 (5740-XY5) 
CKDS activity flags 82 KG 
function code 82 43 2B 
installation exit data 82 IDAT 
job/step name, RACF user/ 
group flag 82 40 28 
number of variable relocate 
sections 82 41 29 
options 82 CRYP 
return code 82 44 2C 
Programmer’s accounting number 26* 104 68 
Programmer’s building 26** 390 186 
59 98 62 
Programmer's department 26** 382 175 
59 90 5A 
Programmer's name . 5 97 61 


30 Identification section 

20 44 2C 

26 68 44 

57** 46 2E 

59 62 3E 
Programmer's room number 26* 108 SC 


26* 398 18E 
59 82 52 


Punch route code, job 26* 134 86 
Punched cards, number of 26 120 78 
Punched cards generated to spool, 26* 216 D8 
number of 26** 256 100 
RACF Group ID 20 REL 


30 Identification section 
32 Identification section 


RACF Terminal 1D 20 REL 
30 Identification section 
32 Identification section 
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. Record Offset \ 
Field Description Type Dec. Hex. 
RACF User ID 20 REL 
| ~ 30 Identification section 
32 Identification section 
RBA, highest used 64 134 86 
READ buffers used 50 54 36 (5735-RC2) 
READ channel! programs 50 34 22 (5735-RC2) 
Read errors, number of 21 32 20 
21 36 24 
Read or write accesses to an overflow 14 ISAM 
record, number of 15 ISAM 
Reader device class 5 73 49 
30 |/0 activity section 
Reader device type 30 1/0 activity section 
Reader end date 5 62 3E 
30 Identification section 
26* 152 98 
26** 192 co 
Reader end time 5 58 3A 
26* 148 94 
26** 188 BC 
30 Identification section 
Reader start date 4 30 1E 
5 30 1E We 
6 30 1E \ | 
10 30 1E eee 
14 30 1E 
15 30 1E 
17 30 1E 
18 30 1E 
20 30 1E 
25** 30 1E 
26 30 1E 


30 Identification section 
32 Identification section 


36 68 44 
40 30 1E 
Reader start date 60 62 3E 
61 62 3E 
62. 30 1E 
63 30 1E 
64 30 1E 
65 62 ~—6S3E 
66 62 3E 
67 30 1E 
|—«éaB 30 1E 
69 30 1E 


78 Private virtual storage section 
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**These records are for JESS. 
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( : Record Offset 





Field Description Type Dec. Hex. 

Reader start time 4 26 1A 
5 26 1A 
6 26 1A 
10 26 1A 
14 26 | 1A 
17 26 1A 
18 26 1A 
20 26 1A 
25** 26 1A 
268 26 1A 


30 Identification section 
32 Identification section 


36 64 40 
40 26 1A 
60 58 3A 
61 58 3A 
62 26 1A 
63 26 1A 
64 26 1A 
65 58 3A 
66 58 3A 
67 26 1A 
68 26 1A 
69 26 1A 
78 Private virtual storage section 
Reader unit type 5 74 4A 
| 30 1/0 activity section 
( RECEIVE count 48** 56 38 
" RECEIVE level ib DBm 37 12 
RECEIVE Level in DBm, minimum 37 14 E 
RECEIVE, negative response count 48** 62 3E 
RECEIVE, positive response count 48** 66 42 
Real storage, number of bytes in 0 31 1F 
Record format 14 246 F6 
15 246 F6 
Record indicator 4 102 66 
14 42 2A 
15 42 2A 
22 18 12 
30 Completion section 
34 102 66 
40 44. 2c 
47 24 18 
48 24 18 
49 24 18 
60 74 4A 
61 74 4A 
63 42 2A 
65 74 4A 
66 74 4A 
67 42 2A 
Record size, maximum logical 64 DSc 
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*These records are for JES2. 


**These records are for JESS. 


Field Description 


Record Offset 
Type Dec. Hex. 





Record subtype 


Records, logical, number written 


Records deleted, inserted, updated, and 


retrieved from component, number of 
Records in component, number of 


Records in overflow and prime data 
areas, number of logical 


Record type 
Record written date 


Record written time 
Records lost, number of 


Records transmitted or 
received, number of 


Recording data set new/old 


‘Region requested 


Region size, maximum possible 


Region size established or assigned 


Relative address of last record 
processed for a physical sequential 
or partitioned data set 


Relative byte address, highest used 
Release number of operating system 


Remote name 


Requests for disk/volume, number of 


Requests queued for the logical 
control unit 


Requests queued in IOS for the device 


Re-read count 


Reserve, address of the device 
against which is issued 
Reserve, name of the job that issued 


Reserve, system identifier for the job 
that issued 


RESTART threshold 


Resource 
number of requests 
major/minor name 


max/min/total contention 
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24 22 16 
60 22 16 
61 22 16 
65 22 16 
66 22 16 
6 51 33 
64 STAT 

64 STAT 

14 ISAM 

15 ISAM 

ALL 5 5 
36 10 A 
36 6 6 

7 18 12 


24 General section 


90 Subsystem recording section 
78 Private virtual storage section 


78 Common virtual storage section 


4 82 52 

30 Storage and paging section 
34 82 52 

78 Private virtual storage section 
14 DCB 

15 DCB 

64 134 86 


90 IPL SMF section 
24 SYSOUT selection criteria section 


47 28 1C 
48 28 1c 
49 28 1C 


52* Identification section 
54* identification section 


25** 48 30 
78 Subtype 1 1/O queuing data section 


74 Device data section 
79 Subtype 9 device data section 


30 28 1C 


79 Subtype 6 (SENOR) data section 


79 Subtype 6 (SENOR) data section 
79 Subtype 6 (SENOR) data section 


31 30 1E 


77 Enqueue section 
77 Enqueue section 
79 Subtypes 6 and 7 (SENO/SENOR) data sections 
77 Enqueue section 





























Cc 
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*These records are for JES2. 


**These records are for JESS. 





Field Description 


Resource factor coefficient 
CPU 
ERV 
lOc 


Resource name, failing 
Resource type, failing 
Response delay, total 
Response time definition 
RETKEY flags 


RETKEY key name 
Reverse explicit route number 


RMF samples, number of 


RME version number 


Room number, programmers 


Route code 


Route element name 

Route element table 

Sample sets in RMF trace number of 
Samples, invalid 

Sampling cycle length 

Security Product ID 

Segment descriptor 


Selection attempts delayed by 
control unit busy 


Selection attempts, total 
SEND count 
SEND, negative response count 


SEND, positive response count 


Service, CPU 


Service, |/O 


Service, job 


Service, main storage 
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Record Offset 
Type Dec. Hex. 


72 Workload control section 
72 Workload control section 
72 Workload control section 


37 All section 
37 All section 
39 28 1C 
39 22 16 


82 RETK 

82 RETK 

39 100 64 
70-79 24 18 
70-79 O 


26* 108 6C 
26** 398 18E 


6* 92 5C 
6* Routing section 

26* 94 5E 
26* 132 84 
26* 134 86 
26* Routine section 


39 0 0 
39 6 6 
76 0 0 
78 2 2 


70-79 36 24 
82 22 16 
39 2 2 

78 16 10 


78 Subtype 1 (I/O queuing data section) 


48** 52 34 
48** 60 3C 
48** 64 40 

4 REL 

5 REL 

30 Perforamnce section 

34 REL 

35 REL 

4 REL 

5 REL 

30 Performance section 

34 REL 

35 REL 

5 80 50 

30 Performance section 

35 80 50 

4 REL 

5 REL 

30 Performance section 

34 REL 

35 REL 
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Field Description 


Service, MSO units 
Service, SRB 


Service, step 


Service, total 
Session name 

SID parameter 
Situation indicator 
SIOT TTR address 


Size of catalog record 


Size of control interval 


Size of private area 


Size of terminal status block 
Size of time-sharing buffer 
SLU domain name 

SLU link name 

SLU subarea PU 

SMF options 


Sort 


number of records processed © 


processor time used 


SORTIN access method 


SOR TOUT 
Number of cells 


Spindle identification 


SRB service 


SRB service definition coefficient 


SRM measure of the ASM queue 


length 

SRM service for a step 
SOA usage 

SOA size 

SSID of device 
Staging adapters 
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Record. Offset 


Type Dec. Hex 





30 Performance section 


4 REL 

5 REL 

30 Performance section 
34 REL 

35 REL 

4 REL 

30 Performance section 
34 REL 

30 Performance section 
79 6 6 
ALL 14 E 

64 42 2A 
14 64 40 
15 64 40 
63 44 2C 
63 46 2E 
67 132 84 
64 DSC 

4 74 4A 
34 74 4A 
31 36 24 
31 20 14 
39 74 4A 
39 58 3A 
39 74 4A 

0 30 1E 


90 SMF command section 


16 Data section 
16 Data section 


16 83 53 
16 91 5B 


16 92 5C 


64 EXT 

69 44 2C 
4 REL 

5 REL 

30 Performance section 
34 REL 

35 REL 

72 38 26 


79 Subtype 3 (SRCS) data section 


79 Subtype 2 (ARD/ARD4J) data section 
78 Common virtual storage section 

78 Common virtual storage section 

22 VAR | 

22 MSS 


























*These records are for JES2 | 








Field Description 

Staging spindles in staging data 
groups 

Start date 


job transmitter 
SYSOUT transmission 


Start date of recording when SMF data 
set became available 


START SSCH instructions, number of 


Start time 
job transmitter 
SYSOUT transmitter 


Start time of recording when SMF 
data set became available 


Start/warm start indicator 


Step accounting fields 


Step completion code 


Step CPU time 


Step initiation time 


Step initiation date 


Step name 


Step number 


Step performance group number 


Step service 


Step termination date 


Step termination indicator 





Record Offset 
Type Dec. Hex. 


22 MSS 


26* Network section 


57* 76 4C 
7 24 18 
21 34 22 


74 Device data section 
79 Subtype 11 (PGSP) data set section 


26* Network section 


57* 72 48 
7 20 14 
43 26 1A 
4 ACT 

30 Accounting section 
34 ACT 

4 55 37 
30 Completion section 
34 55 37 
4 99 63 
4 ACT 

30 Processor accounting section 
34 99 63 
34 ACT 


30 Identification section 
32 Identification section 


30 Identification section 
32 Identification section 


4 66 42 
30 Identification section 
32 Identification section 
34 66 42 


78 Private virtual storage section 
82 32 20 (5740-XY5, -XY6) 


4 42 2A 
30 Identification section 
32 Identification section 


34 42 2A 
40 42 2A 
4 REL 

5 92 5C 


30 Identification section 
32 Identification section 


34 REL 

35 92 5C 
4 REL 

34 REL 

4 10 A 
30 10 A 
34 10 A 

4 87 53 
30 Completion section 
34 87 53 
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*These records are for JES2. 








‘Field Description 


Step termination time 


Step transaction active time 


Step transaction residency time 


Stop date 
job transmitter 
SYSOUT transmitter 


Stop time 
job transmitter 
SYSOUT transmitter 


Storage, extended, number of 


4k frames 
Storage, real, number of bytes in 


Storage, used from bottom of 
private area 


Storage, used from top of private area 


Storage, virtual, number of bytes in 


Storage protect key 


Subpool usage 


Subsystem associated with PGN 


Subsystem identification 


Subsystem identification of device 
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Record | Offset ( 
Type Dec. Hex. ee, 

4 6 6 

30 6 6 

34 6 6 

4 REL 

30 Performance section 

34 REL 

4 REL 

30 Performance section 

34 REL | 


26* Network section 
57* 84 54 


26* Network section 
57* 80 50 


22 Extended storage section 


0 31 1F 


4 78 4E 

30 Storage section 

34 78 4E 

78 Private virtual storage section 


4 76 4C 

30 Storage section 

34 76 4C ra SS 
78 Private virtual storage section \ J 

My oe 

0 26 1A 

4 86 56 

5 76 4C 


30 Storage section 
34 86 56 
35 76 4C 


78 Common virtual storage secton 
78 Private virtual storage section 


72 58 3A 


6 62 3E 
26 46 2E 
30 18 12 
32 18 12 
43 18 12 
45 18 12 
47 18 12 
48 18 12 
49 18 12 


22 VAR 


























*These records are for JES2. 
** These records are for JESS. 


Field Description 


Swap candidates, number of 


Swap sequences, number of 


Swap-ins, number of 


Swap-outs, number of 


Swaps, 
directed to auxiliary storage 
logical 
physical 
directed to extended storage 
physical 
migrated from extended storage 


SYSOUT class 


‘SYSOUT transmitter 


start date 
start time 
stop date 
stop time 
system identifier 


System identification 
System identification from $E SYS 


command 


System indicator 





Record 








Offset 
Type Dec. Hex. 


71 Swap placement section 


4 REL 

30 Storage and paging section 
34 REL 

71 Swap placement section 

4 REL 

30 Storage and paging section 
34 REL 

4 REL 

30 Storage and paging section 
34 REL 


71 Swap placement section 
71 Swap placement section 


71 Swap placement section 
71 Swap placement section 


6 42 2A 
24 SYSOUT selection criteria section 


57* 76 4C 
57* 72 48 
57* 84 54 
57* 80 50 
57* 96 60 
ALL 14 E 

26* Network section 
43* 28 1C 
ALL 4 4 
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*These records are for JES2. 
~ **These records are for JES3. 





Field Description 


Record Offset 
Type Dec. Hex. 





System name (if NJP) 


Tape density 

Tape unit serial 

Tape volumes requested, number of 
TCB time for step 

Temporary read forward errors 


Temporary read errors, number of 
(non-buffered log) 


Temporary read backward errors 


Temporary write errors, number of 
(non buffered log) 


Temporary write errors, number of 


Terminal input lines, number of 
Terminal output lines, number of 


Terminal status block, size of 


Terminal wait 
number of logical swapout candidates 


Termination indicator, JES2 or JES3 


Termination indicator, job 
Termination indicator, step 


TGET, count for group 
TGETs satisfied, number of 


Time, continuous wait 


Time, deadline schedule 

Time DFSORT started processing 
Time DFSORT ended processing 
Time, execution 

Time, JES3 allocation requests 
Time, JES3 device verification 


Time, job CPU 
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26** 96 60 


26** 144 90 
26** 152 98 


21 43 2B 
21 47 2F 
25** 44 2C 
79 ARD/ARDS section 
21 50 32 
21 32 20 
21 52 34 
21 33 21 
21 54 36 
30 I/O activity section 
34 51 33 
35 51 33 
30 1/0 activity section 
34 47 2F 
35 47 2F 
31 36 24 


71 Swap placement section 


45 24 18 
5 66 42 
30 Completion section 
35 66 42 
4 87 57 
30 Completion section 
34 87 57 


32 Cammand section 
30 {/O activity section 


34 51 33 
35 51 33 
0 18 12 


26** 168 A8 
16 40 28 
16 48 30 
26 112 70 
25** 76 4C 
25** 84 54 


5 77 40 
5 117 75 
30 Completion section 
35 77 4D 
35 117 75 





£o~ 
ee \ 


' N 
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*These records are for JES2. 
**These records are for JESS. 








ee, Record Offset 
( Fieid Description Type Dec. Hex. 





Time, IPL 
Time, logoff 


Time, logon 


Time, logan enqueue 


Time, step CPU 


Time, job transaction active 


Time, step transaction active 


Time, transaction queued 
Time, transaction completed 


Time *START SETUP command 
issued: 
Time converter started 


Time converter stopped 


Time device allocation started 


Time execution processor started 


Time execution processor stopped 


Time fetch processing ended 


Time ail volume mount message 
issued 


Time initiator selected step/job 


Time job terminated 


Time object was ACCESSed 
Time object was UNACCESSed 
Time output processor started 


Time output processor stopped 





90 Self-defining section 


30 6 6 

35 6 6 

30 6 6 

34 26 1A 
35 26 1A 
30 identification section 
35 58 3A 

4 99 63 

4 ACT 

30 Processor activity section 
34 99 63 
34 ACT 

5 84 54 

30 Performance section 
35 84 54 

4 REL 

30 Performance section 
34 REL 


59 Transaction data 


59 Transaction data 
25** 60 3C 


26* 156 9C 
26** 196 C4 


26° 164 A4 
26** 204 cc 


4 90 5A 
30 identification section 
32 Identification section 
34 90 5A 


26° 172 AC 
26** 212 D4 


26* 180 B4 


26** 220 DC 
25** 52 34 
25** 76 4c 
4 43 2B 
5 43 28 


30 Identification section 
32 identification section 


34 43 2B 

5 6 6 

30 6 6 

32 Identification section 
35 6 6 


41 Object ACCESS Section 
41 Object UNACCESS Section 


26* 188 BC 
26** 228 E4 


26* 196 C4 
26** 236 EC 
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*These records are for JES2. 
** These records are for JES3. 


1 Except 2, 3 








Record Offset 

Field Description Type Dec. Hex. 
Time output service started 6** 43 28 
-Time-outs to read text, number of 48* 64 40 

4g** 60 3C 
Time print/punch processor started 6* 43 2B 
Time program started 4 94 5E 

30 Identification section 

34 94 5E 
Time reader recognized end of job 5 58 36 


Time reader recognized the JOB card 


Time record was moved to dump 
data set 


Time record was moved to SMF buffer 


Time recording was started when SMF. 
date set became available 


Time step terminated 


Time-sharing buffer size 
Time-sharing buffers, number of 


Time, transaction active, elapsed, 
residency 


TIOT status indicator 


Total {/O calls for reads 
Total {/O calls for writes 
Total re-reads 


Total writes 
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26* 148 94 
26*”* 188 BC 
30 Identification section 
32 Identification section 


4 26 1A 
5 26 1A 
6 26 1A 
10 26 1A 
14 26 1A 
15 26 1A 
17 28 1A 
18 26 1A 
20 26 1A 
24 General section 
25** 26 1A 
26 26 1A 


30 Identification section 
32 Identification section 


40 26 1A 
60 58 3A 
61 58 3A 
62 26 1A 
63 26 1A 
64 26 1A 
65 58 3A 
66 58 3A 
67 26 1A 
68 26 1A 
69 26 1A 
78 Subtype 2 (Private virtual storage section) 
2 6 6 
3 6 6 
ALL' 6 6 
7 20 14 
4 6 6 
30 6 6 
34 6 6 
31 20 14 
31 18 12 


30 Performance section 


14 53 35 
16 53 36 


41 Object {/O Activity Section 
41 Object |/O Activity Section 
41 Object I/O Activity Section 
41 Object I/O Activity Section 

















**These records are for JESS. 
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Field Description 





Record Offset 
Type Dec. Hex. 





TPUT count for group 


TPUTs issued, number of 


Trace options 


Tracks, number in largest 
unallocated extent 


Tracks, number of unallocated 


Tracks, number of unused alternate 
Tracks, number used by sort 


Tracks allocated on device, number of 


Tracks in largest continuous 
unallocated area, number of 


Tracks in overflow area, number of 


Tracks released by DADSM routine, 
number of 


Tracks requested but not allocated, 
number of 


Transaction active time 
Transaction active time, job 


Transaction active time, step 


Transaction name associated with PGN 
Transaction class name 


Transaction elapsed time 
Transaction residency time 


Transaction residency time, job 
Transaction residency time, step 


Transactions, number of 


Transactions, number for group 
Transmission group number 
Transmission path 
Transmission priority 

Triplets supported by DFSORT 


TSB (terminal status block), size of 





32 Command section 


30 1/O activity section 


34 47 2F 
35 47 2F 
76 68 44 
19 58 3A 
19 54 36 
69 50 32 
19 50 32 


16 Data section 


14 UCB 

15 UCB 

69 54 36 
14 ISAM 

15 ISAM 

14 DCB 

15 DCB 


64 132 84 


30 Performance section 


5 88 58 
30 Performance section 
35 88 58 

4 REL 

30 Performance section 
34 REL 

72 82 52 


79 Subtype 8 (TRX) data section 


30 Performance section 
79 Subtype 5 (ASRM/ASRM\J) data section 


30 Performance section 


79 ASRM/ASRM.4J section 
5 68 44 

30 Performance section 
35 68 44 

4 REL 

30 Performance section 
34 REL 


30 Performance section 

32 TSO/command segment 
35 88 58 

72 Performance section 

79 TRX section 


32 Command section 
39 8 8 
57** 146 9A 
39 104 68 
16 44 26 
31 36 24 
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Record Offset — 


Field Description Type Dec, Hex. 





TSO user identification 
TSO, command name 


TSO, number of commands 


26** 96 60 
32 Command section 


32 Command section 


TTR of JECB or SIOT 14 64 40 
15 64 40 
TTRN of last record processed for a 14 DCB 
physical sequential or partitioned 15 DCB 


data set 
Type of deadline schedule 


Type of 1/O macro instruction and 
options 


UCS image identification 


UIC 
average high 
maximum high 
minimum high 


26** 124 7C 


14 247 F7 
15 247 F7 


6 88 58 
24 SYSOUT selection criteria section 


70 Paging data section 
70 Paging data section 
70 Paging data section 


UNACCESS data section, offset of object 41 44 2C 
UNACCESS data section, length of object 41. 48 30 
UNACCESS data section, number 41 50 32 


of object 

Unique session 1D (PCID) 
Unit address, cryptographic 
Unit status, cryptographic 


ee 

Unit type 5 74 4A 

8 DEV 

9 DEV 

10 DEV 

11 DEV 

14 UCB 

15 UCB 

19 36 24 

21 28 1C 

30 EXCP section 

34 DEV 

40 DEV 

62 VOL 

64 EXT 

75 103 67 
Unit type 74 12 C 

79 12 C 
Updated records, number of 64 STAT 


39 106 6A 


82 Cryptographic unit section (5740-XY6) 


82 Cryptographic unit section (5 740-XY6) 
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** These records are for JES3. 
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Record Offset 
Field Description Type Dec. Hex. 





User identification 4 34 22 
5 34 22 
6 34 22 


10 34 22 
14 34 22 
15 34 22 
17 34 22 
18 34 22 
20 34 22 
25** 34 22 
26 34 22 
30 Identification section 
32 Identification section 
34 34 22 
35 34 22 
40 34 22 
57** 66 42 
60 66 42 
61 66 42 
62 34 22 
63 34 22 
65 66 42 
66 66 42 


User identification (continued) 67 34 22 
68 34 22 
69 34 22 
82 24 18 


Vector Facility affinity time for 30 32 20 
( initiator processing 
; Vector Facility affinity time for 30 28 iC 
job/step processing 
Vector Facility usage time for 30 24 18 
initiator processing 
Vector Facility usage time for 30 20 14 
job/step processing 
Vector Facility online indicator 22 CPU section 
VIO page reclaims, number of 4 REL 
30 Storage section 
34 REL 
VIO page-ins, number of 4 REL 
30 Storage section 
34 REL 
VIO page-outs, number of 4 REL 
30 Storage section 
34 REL 
VIO pages, accepted by data set 75 Page/swap data set data section 
| 79 Subtype 11 (PGSP) data set section 
Virtual route number 39 102 66 
Virtual storage allocated from LSQA 30 80 50 
and SWA 30 80 54 | 
78 Subtype 2 (Private virtual storage section) 
Virtual storage allocated fro.) user 30 88 58 
subpools 30 92 5C 
_ 78 Subtype 2 (Private virtual storage section) 
( Virtual storage, free 78 Subtype 2 (Common virtual storage section) 
ae 78 Subtype 2 (Private virtua: ztorage section) 


**These records are for JES3. Virtual storage, number of bytes in 0 © 26 1A 
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Record Offset 
Field Description Type Dec. Hex. 
Virtual storage, used 78 Subtype 2 (Common virtual storage section) 
78 Subtype 2 (private virtual storage section) 
Volume mount completion message 25** 80. 50 
date 
Volume mount completion message 25°" 6 4C 
time 
Volume owner identification 19 26 1A 
Volume requests, MSS 25** 92 5C 
Volume sequence number 14 254 FE 
15 254 FE 
Volume serial number 14 UCB 
15 UCB 
17 VOL 
18 VOL 
19 20 14 
21 20 14 
59 Transaction type section 
62 90 5A 
62 VOL 
64 EXT 
69 100 64 
74 Device section 
75 109 60 
79 Subtype 9 device section 
79 Subtype 11 (PGSP) data section 
Volume serial of the volume mounted 74 6 6 e 
79 Subtype 11 (PGSP) data section : 
\. sy 
Volumes, number of 17 91 58 Bee 
Volumes fetch messages, number of 25** 44 2C 
Volumes mounted by MDS, number ort 25** 68 44 
VSAM Volume data set name 60 75 4B 
VSAM Volume record 60 208 DO 
VTOC address 19 40 28 
VTOC indicator 19 45 2C 
Warm start/start indicator 43 26 1A 
Work station name 47** 28 1C 
48** 28 1C 
47** 28 1c 
Workload contro! section, offset to 72 36 24 
Worst Line Quality 37 8 8 
Write errors, number of 21 33 21 


21 37 | 25 





**T hese records are for JES3. 
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Chapter 8: EXCP Count 


SMF record types 4, 14, 15, 30, 32, 34, 40, and 64 have fields that contain a count 
related to the I/O activity for a given job, job step, or interval. These fields are 
called EXCP counts. There are two levels of EXCP counts; the DD level and the 


address space level. The type 30 record provides the address space level counts in the 
au O Activity section and the DDLEVEL counts in the EXCP section. All other records 
provide only the DDLEVEL. 


DD Level 


The DD level EXCP count includes: 
e 1/O for system services, for example: 
— Joblib/steplib processing 
— Jobcat/stepcat processing 
— Overlay supervisor processing 
— Checkpoint data set processing 
e I/O for VSAM data sets (SVC 121) 
e Number of 4k blocks for DIV objects (including reads, writes and re-reads). 
e EXCPs issued via an EXCP macro (SVC 0) 
e EXCPs issued via TCBEXCP macro (SVC 92) 
EXCPs issued via an EXCPVR macro (SVC 114) 
EXCPs issued in a system or user provided channel-end appendage 
EXCPs issued in an abnormal-end appendage 
EXCPs for VIO data sets 


EXCPs issued to the SYSUDUMP, SYSABEND, and SYSMDUMP data sets 
when these data sets reside on a direct access or tape device. 


The DD level EXCP count does not include: 


e EXCPs issued in a PCI appendage when ADDRSPC=REAL 


e EXCPs handled by the job entry subsystem 
@ TPUTs and TGETs handled by macro instructions (For TPUTs and TGETs, 


EXCPs are accumulated on a system basis in the TCT and are contained in 
SMF record types 30, 32 (if detail is specified), 34 and 35 only.) 


For sequential access methods (BSAM, QSAM, and BPAM), the EXCP count 
represents a block count when default scheduling is used. That is, each end-of- 
block encountered in the problem program increases the EXCP count by one. 
For other access methods (such as BDAM, ISAM, and VSAM) the count repre- 
sents Start I/O requests. 


Only the type 6 and type 26 SMF records contain counts for a job or a job 
step I/O activity to spool data sets managed by either job entry subsystem. 
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Address Space Level 


The address space level EXCP count in the type 30 record contains all of the 
I/O counts described for the DD level, plus the following: 


Library searches and fetches from data sets in the LINKLIST. 

I/O initiated to the JES2 spool data sets from the address space being reported. 
Catalog management I/O activity. 

OPEN and CLOSE I/O activity beyond priming and purging the buffer. 


The address space EXCP level excludes all of the I/O counts that the DD level 


excludes, plus the following: 


Paging and swapping I/O activity. 
VTAM I/O activity 

JES3 spool I/O activity 

MSCC, OLTEP, and IOS retry 


Notes: 


1. 


8-2 System Management Facilities (SMF) 


In SMF record types 14 and 15, the EXCP count accumulates over the entire job 
step. Therefore, if a data set is opened and closed twiced during a single job step, 
the count in the second record is the sum of all EXCPs for both uses of the data 
set. For multivolume files (such as tape files), the EXCP count is accumulated 
over the volumes. 


. The EXCP count in the last type 14 and 15 records for a given job step equals the 


corresponding entry for the data set in the type 4 and 34 records. 


. If a concatenated data set contains more than one data set member with the 


same physical device, the EXCP count is accumulated in the first data set entry 
having that device entry. 


. If a GETMAN for the expanding TCTIOT data area (where the EXCP count is 


maintained) fails, only the existing data sets are counted. 


. If a data set is dynamically unallocated, the EXCP count is in record types 30 


and 40; there is no EXCP-count entry in record types 4 and 34. 





























Chapter 9: CPU Time 


SMF record types 4, 5, 30, 32, 34 and 35 have fields that contain the job and job 
step CPU times. This chapter summarizes the different times that are included 
and those that are excluded in these CPU-time fields. This chapter also lists a few 
examples of some of the major causes of CPU-time variation between different 


runs of the same job or job step. 


Job step-CPU time is the amount of time devoted by the central processing unit 
to the execution of instructions for a given job step. Job CPU time is the sum of 
job step CPU times for all of the steps in a given job. CPU timing is done by the 
dispatcher on an address space basis. The accumulation of CPU time is separated 
into two fields: execution under TCBs and execution time under SRBs. 


CPU Time Under TCBs 


When a job step is set dispatchable by the initiator, the accumulated job step time 
field for tasks (ASCBEJST) is initialized to zero. Task CPU time is determined as 
follows: 


1. Whenever any task is dispatched, the CPU timer is set to the value of the task 
timer queue element (TQE). Ifa task TQE does not exist, the timer is set to a 


value that would not expire over a period of 208 days (208 day value). 

2. Whenever an I/O, program check, or external interrupt occurs, the CPU timer 
value is stored in PSACPUT. In addition, the value is stored: 
e@ By the dispatcher, when entered at the IEAODS entry point. 


@ By the lock manager, when suspending a task for a local or any cross memory 
service locks. 


e By the program check FLIH suspend routine, when suspending a task for a 
page fix. 
3. Whenever STATUS is saved for a unit of work, the CPU time attributed to the 
pre-empted task is accumulated in the ASCBEJST field as follows: 


a. If a task TQE does not exist, the CPU time is accumulated by adding the 
difference between the 208 day value and the PSACPUT to the ASCBEJST 
value. 


ASCBEJST=ASCBEJST+(208 day value-PSACPUT value) 
This excludes the interrupt handling and suspension time from the task time. 


b. If a task TQE exists and the CPU timer is not a negative value, the CPU time 
is accumulated by adding the difference between the TQE value and the 
PSACPUT value to the ASCBEJST value. 


ASCBEJST=ASCBEJST+(TQE value-PSACPUT value) 


c. Ifa task TQE exists and the CPU timer is a negative value, the CPU time is 
accumulated by adding the TQE value to the ASCBEJST value. 


ASCBJEST=ASCBEJST+TQE value 


‘Chapter 9: CPU Time 9-1 











Notes, ae 


1. If the current task uses the Vector Facility (VF), the system also accumulates \ 
VE affinity time and VF usage time. 


e VF affinity time is a subset of job step time for tasks (ASCBEJST). When the 
task first uses a vector instruction, it is given affinity to only the processors 
that have the Vector Facility. It keeps this affinity until the dispatcher detects 
that vector instructions have not been used for a long time. If the dispatcher 
detects that vector instructions have not been used for a long time it removes the 
special affinity. VF affinity time is the job step time for tasks that was accumu- 
lated while the task had affinity to processors with the Vector Facility. This 
time is useful for capacity management of the Vector Facility. VF affinity time 
is accumulated in the ASSBVFAT field of the ASSB. 


e VF usage time is a subset of the VF affinity time. It is the time that the task 
actually spent executing vector instructions. VF usage time is accumulated in 
the ASSBEVST field of the ASSB. 

(The units for VF affinity and VF usage time are the same units as TCB time) 

2. If the current task is the RCT task, CPU time is not accumulated. This elimi- 
nates the time that is spent in swap-out/swap-in processing and its purging of 
I/O. In the case of page faults that result in suspension of the current task, the 
PSACPUT value represents the CPU timer value when the program check (page 
fault) occurred. In the case of a synchronous page fix that results in suspension 
of the current task, the CPU timer is stored in the PSACPUT field during the 
suspend processing so that the suspension time is not included in the ASCBEJST. 
The result is that suspend time is excluded from the task time. 


CPU timing is continually accumulated as described above until the job step 
terminates. At that time the CPU time in the ASCBEJST field is moved into the 
ACTJTIME field in the account control tables of the JCT. It is from this field that 
SMF obtains the ‘‘CPU time under TCBs”’ value for its records. 


Included/Excluded TCB Times 


Timing values accumulated for the address space under TCB control include: 
e Problem program time. 
SVCs 
Lock spins encountered in an MP environment 
EMS (emergency signals between CPUs) interrupt occuring within a lock spin 
Abend/Abterm 
User SPIE exit processing 


Times excluded are: 

e I/O interrupt time 

External interrupt time 

Page fault processing 

CPU “stopped” time if the QUIESCE command is used 


RCT time (swap-out/swap-in processing and I/O error recovery processing) 
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e Attention processing time for TSO 


e@ Program check handling 


CPU Time Under SRBs 


When a job step is set dispatchable by the initiator, the accumulated job step time 
field for SRBs (ASCBSRBT) is initialized to zeros. SRB time is determined as 
follows: 


1. Whenever the SRB is dispatched; the CPU timer is set to a value that will not 
expire over a period of 208 days (208 day value). 


2. Whenever the SRB terminates, the CPU tinic is accumulated by adding the 
difference between the 208 day value andthe PSACPUT value to the 
ASCBSRBT value. 


ASCBSRBT = ASCBSRBT + (208 day value — PSACPUT) 

3. If an SRB is suspended for a page fix, page fault, the local lock, or the CMS 
lock, the CPU timer value is saved in the SSRB. Whenever the suspended SRB is 
redispatched, the CPU timer is reset from the saved value. Whenever the SRM 


and RMF timer expires, time spent in processing SRM and RMF is not included 
in SRB time. 


CPU timing is continually accumulated until the job step terminates. At that time 
the CPU time in the ASCBSRBT field is moved into the SCTSRBT field for use by 
SMF. 


Included /Excluded SRB Times 


Services that use SRBs to perform the following functions will have their 
execution time accumulated for the address space: 


e Swap control 

e Cross-memory communications 

e TQE scheduling 

e Any supervisor service under SRB control 
e SRM/RSM page stealing 

e I/O completion processing 


The following functions will execute without affecting the time accumulated 
for the address space. 


e Lock request suspension 
@ SRM and RMF timer expiration processing 
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CPU-Time Variation 





There are many reasons why CPU time varies between different runs of the same 
job or job step. The following list describes some of the major causes of variation: 


e Cycle stealing on systems with integrated channels ~ CPU 
instruction execution is temporarily suspended when channels require the use of 
hardware resources shared with the CPU. 


CPUs using.a high speed buffer — CPU time may vary due to any 

of the following: 

— Buffer interference caused by concurrent tasks 

— Partial or full disabling of a buffer because of storage errors 

— Translation lookaside buffer (TLB) affect on MIPS or instruction speed 


Storage access — The CPU cannot access real storage if a channel is using it. 
Storage-access time depends on CPU architecture such as interleaving, data 
widths and paths. 


DASD space allocation — If the number of extents is not exactly the same as 
before, additional end-of-extent processing is required. 


@ Temporary i/O errors — Additional SVCs such as SVC 15 (ERREXCP), SVC 16 
(PURGE), and SVC 55 (EOV) may be required for temporary I/O errors. 


e@ EXCP request (SVC 0) — The time to process an EXCP request varies depending 
on the availability status of the requested device and channel. Some 
possibilities are: 

(a) The device and primary channel are available — the SIO preparation and 
execution are done immediately. 


(b) The device is available, the primary channel is busy, but one of the alternate 
channels is available — the time to test alternate channels is added to the 
time required in (a). 

(c) All devices and channels are busy — the request must be queued on a FIFO 
basis. 


e BLDL/FIND requests — If BPAM is used extensively, CPU time for processing 
BLDL/FIND requests varies if there was a change in the PDS directory. That is, 
a change in the location of the entry for the required member is reflected by a 
change in the time needed to find the block containing it. 


@ STOW processing — A difference in the PDS directory may also vary STOW 
processing time because of the additional reordering or bumping that may be 
necessary. 


e Macro processing — Processing time for macros such as LINK, LOAD, XCTL, 
ATTACH and BLDL is affected by where the requested module is located. For 
éxampic, CPU time may be less if the module is in the LPA and joblibs and 
steplibs are not used. 
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Availability of serially reusable resources (locks),— System ENQ routine time will 
vary depending on whether the resource is available. If a resource is not available, 
additional time is taken to queue up the current request and to wake the 
requester. DEQ time also increases if other tasks have subsequently requested 

the resource that the current task is releasing. 


Wait processing — CPU time varies depending on whether or not ECBs have been 
posted prior to issuance of the WAIT macro instruction. 


Lock spins — If a job is run on an MP, CPU time may vary due to lock spins 
encountered in supervisor services. 


Queue searching — System service time varies with the status of the queue 
environment. For instance, the time to process an ENQ request varies with the 
number of QCBs to be examined and chained, and whether or not storage must 
be obtained for new QCBs. The time to process a GETMAIN request varies with 
the length of the FQE chain; FREEMAIN time varies with the status (free or 
allocated) of the adjacent areas. Also, global queue searching affects SVC time; 
for example, GETMAIN is greatly affected if storage is fragmented. 


Time requests — For task and real time requests, timer ENQ routine processing 
time varies with the number of elements on the timer queue that must be 
checked to find the proper slot for the current request. 


WTO, WTOR and WTL processing — CPU time may vary depending on the time 
required to find a free WQE and/or RQE, and possibly on whether a 

GETMAIN is necessary to build a new element. If the WTO or reply elements 
are at their limit, additional time is required for enqueuing. 


Generalized trace facility (GTF) — When GTF is active, CPU time increases 
depending on the system functions (SVC, SIO, IO, PCI, DSP) that are selected 
for current GTF recording. If USR functions are to be recorded and the 
application contains GTRACE macros, the CPU time variability is even more 
pronounced. 


FREEMAIN resulting in available real page — When a FREEMAIN results in 
making a real page available to an MP system, the page must be invalidated and 
both CPUs’ translation lookaside buffers must be purged of the entry. The 
invalidation and purge are synchronous: one CPU may wait (spin) a variable 
amount of time until the other CPU is enabled to receive a signal 

(EMS interrupt) and perform the synchronizing function. 


System resource manager (SRM) — SRM is run either scheduled ‘as an SRB, as a 
subroutine of quiesce (RCT), or as a subroutine of a service invoked by a job. 
SRM execution may cause CPU time to vary when it is invoked from supervisor 
services that issue SYSEVENTS, such as ENQ, WAIT (LONG=YES option), TPUT 
and TGET. 


SRM page stealing — SRM page stealing affects the number of page faults that 
a particular job incurs. CPU time varies depending on both the number of page 
faults resolved by I/O and the number of page faults resolved by reclaim. 


Sequential access method and chain scheduling — CPU time can vary from run 
to run depending on the amount of chain scheduling that was successful. The 
number of starts for I/O will vary under different system loads. 
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| 9.6 System Management Facilities (SMF) 






































Chapter 10: SMF Exit-System Interface Diagrams 


This chapter contains diagrams for each SMF exit that show the system 
interface(s) for the exit. Each diagram illustrates the general flow of events that 
occur before and after an SMF exit receives control. Note that the diagrams do 
not indicate the specific control path between system modules. 


The system interfaces for the following SMF exits are illustrated. 


Figure 10-1. 
Figure 10-2. 
Figure 10-3. 
Figure 10-4. 
Figure 10-5. 
Figure 10-6. 
Figure 10-7. 
Figure 10-8. 
Figure 10-9. 


IEFUJV — Job Validation Exit (Converter) 

IEFUJV — Job Validation Exit (Interpreter) 

IEFUJI — Job Initiation Exit and IEFUSI — Step Initiation Exit 
IEFUTL — Time Limit Exit 

IEFUSO — JES2 SYSOUT Limit Exit 

IEFUSO — JES3 SYSOUT Limit Exit 

IEFU83 — SMF Record Exit 

IEFU84 — SMF Record Exit 

JEFACTRT — Termination Exit 


Figure 10-10. IEFUJP — JES2 Job Purge Exit 
Figure 10-11. IEFUJP — JES3 Job Purge Exit 
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Figure 10-1. IEFUJV — Job Validation Exit (Converter) 
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Figure 10-2. IEFUJV — Job Validation Exit (Interpreter) 


Chapter 10: SMF Exit-System Interface Diagrams 10-3 














A 


















Initiator selects quem 
a | SMF Initialization Is SAM 


Exit Support active and 
(JEFSMFIE) operational 
? 
Construct timing 

control table 

(TCT) 






Step Initiation 
Routine 
(1EFSD101) 





First step of 
job ? 


Build SMF record 
type 20 


Is step 
exit to be 
taken ? 


Set indicator if 
job or step to be 
cancelled 


Set VSM limit 
indicators 


Step Initiation 
Routine 
(1EFSD101) 


Data Set Enqueue 
and ATTACH 
Interface Routines 










Last step of 
job ? 


Yes ; 


Figure 10-3. IEFUJI — Job Initialization Exit and IEFUSI — Step Initialization Exit 
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Figure 10-5. IEFUSO — JES2 SYSOUT Limit Exit 
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Figure 10-6. IEFUSO — JES3 SYSOUT Limit Exit 
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Figure 10-7. IEFU83 — SMF Record Exit 
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Figure 10-8. IEFU84 — SMF Record Exit 
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Figure 10-9. IEFACTRT — Termination Exit (Part 1 of 2) 
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Figure 10-9. IEFACTRT — Termination Exit (Part 2 of 2) 




























Output processing 
completed for job 


JES2 Dispatcher 


JES2 Purge Processor 
(HASPMISC) 


Remove job from 
the system 











Copy common 
exit parameter 
area into a JES2 
buffer 







Build SMF record 
type 26 in another 
JES2 buffer 


JES2 SMF Writer 
(HASPACCT) 







Build parameter 
list for IEFUJP 
exit 








Write SMF record 
type 26 


‘JOB PURGED’ 
message issued 
to operator 








JES2 Dispatcher 


Figure 10-10. IEFUJP — JES2 Job Purge Exit 
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Figure 10-11. IEFUJP — JES3 Job Purge Exit 
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job 9-1 
job step 9-1 


variations, major causes 9-1 
CPU time limits 4-15, 10-5 
cry ptographic 

address 6-231 

initialization 6-222, 6-227 

record 6-218 

status 6-227 

unit support, record written for 6-227 
CSA (common service area), subpools in 4-34 


D 
DATABASE 2 Accounting, record written by 6-236 
DATABASE 2 Accounting, record type 100 6-236 
DATABASE 2 Performance, record written by 6-237 
DATABASE 2 Performance, record type 102 6-237 
DATABASE 2 Statistics, record written by 6-237 
DATABASE 2 Statistics, record-type 101 6-237 
data collection parameters 
data set/direct access volume (DSNAME) 3-2 
SMF /user records (TYPE) 3-2 
system/job/step (SYS or SUBSYS) 3-3, 3-4, 3-5 
temporary data set (REC) 3-2 — 
Data-In-Virtual record 6-115 
data lost record (type 7) 6-33 
data set activity records 
INPUT or RDBACK (type 14) 6-38 
OUTPUT, UPDAT, INOUT, or OUTIN (type 15) 6-42 
data set status records 
rename (type 18) 6-50 
scratch (type 17) 6-49 
data sets 
DD* _ 6-12, 6-90 
DD DATA 6-12, 6-90 
installation-defined 4-6, 4-7 
non-VSAM _ 6-23, 6-50 
SMF (see SMF data sets) 
spin (JES2) 6-20 
spin (JES3) 6-25 
DD* data sets 6-12, 6-90 
DD DATA data sets 6-12, 6-90 
DD level EXCP count 8-1 
deconcatenation request, record written when issued 6-113 
DEFINE access method services command, records written 
when issued 6-151, 6-164 
DEFINE utility 2-4 
defining the use of SMF 3-1 
degradation billing 1-7 
DELETE access method services command, records written 
when issued 6-157, 6-161, 6-164 
demounting user volumes 6-51 
designing a report program 1-4, 5-4 
detail recording, testing of 4-42 


Antayminina intary im a 
dotermining interval time 4-41 


device activity record (type 74) 6-185 

device allocation record, JES3 (type 25) 6-64 

device allocation recovery record (type 10) 6-60 

DEVICE option, record written for specified devices 6-185 
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devices a 
direct access 6-51 — 
move Offline 6-37, 6-56 Be 


move online 6-35, 6-56 
online atIPL 6-56 
recovering 6-35 
reporting on 1-11 
DFSORT statistics, record type 16 (10) 6-43 
direct access volume activity, reporting on 1-13 
direct access volume record (type 19) 6-51 
direct access volume/data set parameter (DSNAME) 3-2 
DISPLAY SMF command 3-15 
distribution libraries, for adding exit routines 2-1 
DSNAME parameter 3-2 
dummy records, performatting data set with 2-4, 5-1 
dump exit routine (see IEFU29 exit routine) 
dump header record (type 2) 6-10 
dump options, SMF 2-9 
dump program, SMF (see IFASMFDP) 
dump trailer record (type 3) 6-11 
dumping SMF data sets (see IFASFMDP) 
dynamic DD record (type 40) 6-113 


E 
efficiency billing 1-8 
end-of-volume 
records written at 
for non-VSAM data sets 6-38, 6-42 


for tape volumes 6-54 ge Ts 
ENQ/DEQ, contention, resources identified 6-194 
enqueue activity record (type 77) 6-194 eee 


ERBMFBPC, record written by 6-207 
ERBMFDCP, record written by 6-165 
ERBMFDDP, record written by 6-185 
ERBMFDEQ, record written by 6-194 
ERBMFDHBP, record written by 6-183 
ERBMFDOQ, record written by 6-197 
ERBMFDPP, record written by 6-170 
ERBMFDSP, record written by 6-187 
ERBMFDTP, record written by 6-191 
ERBMFDWP, record written by 6-180 
ERBSMER mapping macro, for RMF records 6-165 
error Statistics by volume record (type 21) 6-54 
event recording (see also IEFUTL, IEFUSO, and IEFU83 exits) 
examples 
(see also JCL examples) 
SMF data set space requirements 2-4 
SMFFRMT output 5-4 
summary activity report 2-15 
use of SMF data 1-5 
EXCP counts 
address space level 8-1 
DD level 8-1 
executing the SMF dump program 2-11 
exit routines 
SMF 
adding to operating system 2-1 
branching to 4-40 
characteristics of 4-1 
common parameters 4-7 f 
communicating among 4-33 | “a oY 














conventions 4-6 
facilities 4-33 
IEFACTRT (termination exit) 4-20, 10-10 
IEFUJI (job initiation) 4-11, 10-4 
IEFUJP (JES2 job purge) 10-12 
IEFUJP (JES3 job purge) 10-13 
IEFUJP Gob purge) 4-22 
IEFUSV (job validation) 4-9 
IEFUJV (job validation-converter) 10-2 
IEFUJV Gob validation-interpreter) 10-3 
IEFUSI (step initiation) 4-12,10-4 
IEFUSO (JES2 SYSOUT limit) 10-6 
IEFUSO (JES3 SYSOUT limit) 10-7 
IEFUSO (SYSOUT limit) 4-17 
IEFUTL (time limit) 4-15, 10-5 
IEFU29 (SMF dump) 4-23 
IEFU83 (SMF record-SMFWTM macro) 10-8 
IEFU84 (SMF record) 4-18 
IEFU84 (SMF record-SMFEWTM macro) 10-9 
including in operating systems 2-1 
introduction to 4-1 
load module assignments for 2-1 
modules interfacing with 4-2, 4-3 
obtaining additional work areas for 4-34 
parameters passed to 4-2, 4-3 
restrictions 4-5 
return codes 4-2, 4-3 
sample routines 4-3 
system interface diagrams 10-1 
testing 4-25 
using installation-defined data sets with 4-6 
when taken 4-2, 4-3 

external writer, record written by 6-20 


F 
field name, record written for 6-189 
full SMF data set 2-6 


G 

GENKDY function 6-223 

GETMAIN macro instruction 4-26 
global recording options, specifying 3-3 


H 
HALT EOD, operator command, module writing SMF record 
type 90 6-232 
HALT operator command 
function 2-7 
record written when issued 6-51 
HASPINIT, record written by 6-119 
HASPMISC, record written by 6-66, 6-119 
HASPNET, record written by 6-61, 6-137, 6-139, 6-141 
HASPNUC, record written by 6-121 
HASPPRPU, record written by 6-20 





HASPRDR, record written by 6-61 

HASPRTAM, record written by 6-123, 6-126, 6-130, 6-131, 
6-134, 6-136 

header, standard SMF record 6-1 

header, standard SMF record, with subtypes 6-2 

header, standard SMF record, without subtypes 6-3 

hot start, JES3 record written for 6-120 


I 
IASXSD82, record written by 6-20 
IATINTK, record written by 6-120, 6-122 
IATMDBIC, record written by 6-64 
IATNTSD, record written by 6-140 
IATOSWD, record written by 6-25 
IATPURG, record written by 6-64, 6-70 
IATRJM3, record written by 6-127, 6-131 
IATRJM4, record written by 6-127 
IATSNDT, record written by 6-130 
IATSNLC, record written by 6-127 
IATSNLS, record written by 6-11 
ICB2MSG, record written by 6-35, 6-37, 6-56 
ICF alter activity record (type 66) 6-159 
ICF catalog record 
deleted 6-157, 6-159 
exported, record type 36(24) 6-103 
record written when inserted or deleted 6-154 
updated 6-157 
written 6-159 
ICF define activity record (type 61) 6-154 
ICF delete activity record (type 65) 6-157 
ICTCRY82 mapping macro, use in symbolically addressing 
record type 82 6-223, 6-228 
ICTMKGO0, record written by 6-222 
ICTMKMO1, record written by 6-222 
ICTMK04, record written by 6-222 
ICTSMF82 mapping macro, use in symbolically addressing 
record type82 6-223 
ICUCRY82 mapping macro, use in symbolically addressing 
record type82 6-228 
ICUMKM10, record written by 6-227 
ICUMKM11, record written by 6-227 
ICUMKM14, record written by 6-227 
ICUSMF82 mapping macro, use in symbolically addressing 
record type 82 6-228 
IDA0192S, record written by 6-150, 6-153 
IEBDG utility program, creating sample parameter lists with 
4-25, 4-31 
JIEBGENER utility program, executing TESTEXIT with 4-28 
IEBPTPCH utility program 
use in 
sample exit routines 4-4 
sample sort routines 5-2 
TESTEXIT 4-27 
IEBUPDTE utility program 
adding exit routine to EXITLIB with 4-27 
adding SMFPRMxx to SYS1.PARMLIB = 3-13 
executing SMF dump program with 2-13 
executing TESTEXIT with 4-27 
IEDAY1, record written by 6-86 
IEECLEAN, record written by 6-35, 6-37, 6-56 
IEEMB805S, record written by 6-232 
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IEEMB812, record written by 6-232 
IEEMB823, record written by 6-56, 6-232 
IEEMB829, record written by 6-232 
IEEMB836, record written by 6-75 
. TIEEMB842, record written by 6-60 
IEEMB846, IBM-supplied module 3-8 
IEEMBPVST, record written by 6-56 
IEEVPTH, record written by 6-35, 6-37 
IEEVSTGL, record written by 6-56 
IEE2303D, record written by 6-35 
IEE70110, record written by 6-232 
IEE8603D, record written by 6-232 
IEFAB421, record written by 6-37 
IEFAB488, record written by 6-36 
IEFACTRT exit routine 4-20 
diagram of system interfaces 10-10 
parameters passed 4-21 
return codes 4-21 
sample routine 4-5 
System Availability Management (SAM) Function 4-20 
writing system output messages 4-21 
IEFAEASI, record written by 6-75 
IEFDB4F9, record written by 6-113 
IEFSMFIE, record written by 6-49, 6-75 
JEFTB721 
record written by 6-75, 6-87 
job termination 6-95 
step termination 6-90 
IEFTB722 
record constructed by 
job termination 6-17, 6-95 
step termination 6-12, 6-90 
JEFTB727, record written by 6-87 
IEFUJI exit routine 4-11 
diagram of system interface 10-4 
parameters passed 4-12 
return codes 4-12 
sample routine 4-4 
Sample Availability Management (SAM) Function 4-11 
IEFUJP exit routine 4-22 
diagram of system interface 10-12, 10-13 
parameters passed 4-22 
return codes 4-22 
IEFUSV exit routine 4-9 
diagram of system interface 10-2, 10-3 
parameters passed 4-10 
return codes 4-11 
sample routine 44 
IEFUSI exit routine 4-12 
diagram of system interface 10-4 
parameters passed 4-13 
return codes 4-13 
IEFUSO exit routine 4-17 | 
diagram of system interface 10-6, 10-7 
parameters passed 4-17 
return codes 4-17 
IEFUTL exit routine 4-15 
diagram of system interface 10-5 
parameters passed 4-16 
return codes 4-16 
sample routine 44 
IEFU29 exit routine 4-29 
parameters passed 4-23 
return codes 4-23 
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IEFU83 exit routine 4-17 a 
and the SMFWTM macro 4-36 . 
diagram of system interface 10-8 
parameters passed 4-18 
return codes 4-18 
sample routine 4-5 

IEFU84 exit routine 4-18 
and the SMFEWTM macro 4-37 
diagram of system interface 10-9 
parameters passed 4-19 
restrictions 4-6 
return codes 4-19 

IEF6503D, record written by 6-230 

IFASMFDP dump program 
CLEAR function of 2-13 
defining the use of 2-9 
dumping SMF data sets 2-6 
executing 2-11 
records written by 6-10,6-11 
return codes 2-13 
sample JCL for executing 2-11 
sample procedure using START command 2-12 
termination of processing 2-6, 5-1 
use in creating data sets 5-1 
use in preformatting data sets 2-4 

IFASMFR macro instruction 4-35 

IFG0202H, record written by 6-38, 6-42 

IFG0202I, record written by 6-38, 6-42 

IFHSTATR utility program 6-54 

IGCOOOSI, record written by 6-37 

IGCOOO9A, record written by 6-54 

IGCOO12F, record written by 6-56 

IGCO107H, record written by 6-51 SG 

IGCO90SI, record written by 6-37 

IGGOCLBV, record written by 6-151, 6-161, 6-163, 6-164 

IGGOCLED, record written by 6-146, 6-148, 6-159 

IGG0290D, record written by 6-49 

1GG03001, record written by 6-50 

IGX00017, record written by 6-43 

initial program load (see IPL) 

initialization, TIOC 6-86 

initiation record, job (type 20) 6-53 

INOUT, OUTPUT, UPDAT, or OUTIN data set activity record 
(type 15) 6-42 

INPUT or RDBACK data set activity (type 14) 6-38 

input/output (see I/O) 

installation defined data sets 4-5, 4-6 

installation-written routine (see user-written routines) 

Integrated Catalog Facility, records written by (see IGGOCLED 
and ICF) 

integrity 
JES2 record for 6-130, 6-136 
JES3 record for 6-131 

interlock warning 4-15 

interval accounting 3-7 

interval time 4-41, 4-42 

I/O, queuing activity, record written for 6-197 

1/O configuration record (type 8) 6-34 

I/O macro instruction (SMFWTM) 
format 4-36 


return codes 4-36 _ 
Aoo™ 
| 

















IPL records 
configuration (type 22) 6-56 
direct access volume (type 19) 6-51 
I/O configuration (type 8) 6-34 
IPL (type 0) 6-5 

ISTINCTS, record written by 6-132 


J 
JCL examples 
adding exit routines to EXITLIB 4-27 
adding exit routines toSYS1.LPALIB 2-2 
adding SMFPRMO1 toSYS1.PARMLIB 3-13 
allocating space for SMF data sets 2-4 
cataloging SMF data sets 2-4 
dumping SMF data sets using START command 2-12 
executing a sort procedure 5-3 
executing SMF dump program 2-11 
executing SMFFRMT 5-5 
executing TESTEXIT 4-29 
obtaining a list of sample exit routines 4-3 
obtaining a list of sample sort exit routines 5-2 
JES2 integrity record (type 49) 6-130 
JES2 integrity record (type 54) 6-136 
JES2 LOGOFF/stop line record (type 53) 6-134 
JES2 LOGON/start line record (type 52) 6-135 
JES2 network integrity record (type 56) 6-138 
JES2 network SIGNOFF record (type 58) 6-141 
JES2 network SIGNON record (type 55) 6-137 
JES2 network SYSOUT transmission record (type 57) 6-139 
JES2 records 
JES2 integrity (type 49) 6-130 
JES2 integrity (type 54) 6-136 
JES2 job purge (type 26) 6-66 
JES2 LOGOFF /stop line record (type 53) 6-134 
JES2 LOGON/start line record (type 52) 6-133 
JES2 network integrity record (type 56) 6-137 
JES2 network SIGNOFF record (type 58) 6-141 
JES2 network SIGNON record (type 55) 6-137 
JES2 network SYSOUT transmission record (type 57) 6-139 
JES2 SIGNOFF/stop line (type 48) 6-124 
JES2 SIGNON/start line (type 47) 6-123 
JES2 spool offload (type 24) 6-61 
JES2 start (type 43) 6-119 
JES2 write (type 6) 6-20 
JES2 start record (type 43) 6-119 
JES2 withdrawal record (type 45) 6-121 
JES3 initialization, record written during 6-120 
JES3 integrity record (type 49) 6-131 
JES3 networking SYSOUT transmission record (type 57) 
6-140 
JES3 records 
JES3 device allocation (type 25) 6-64 
JES3 integrity (type 49) 6-131 
JES3 job purge (type 26) 6-71 
JES3 networking SYSOUT transmission record (type 57) 
6-140 
JES3 SIGNOFF/stop line/LOGOFF (type 48) 6-127 
JES3 SIGNON/start line/LOGON (type 47) 6-124 
JES3 start (type 43) 6-120 
JES3 stop record (type 45) 6-122 
JES3 writer (type 6) 6-25 
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JES3 start record (type 43) 6-120 
JES3 stop record (type 45) 6-122 
job CPU time limit 6-34 
job initiation exit routine (see [EFUJI exit routine) 
job intiation record (type 20) 6-53 
job output element, record written by 6-20 
job purge exit routine (see IEFUJP exit routine) 
job purge record 
JES2 (type 26) 6-66 
JES3 (type 26) 6-70 
job termination records 
for background jobs (type 5) 6-17 
for foreground jobs (type 35) 6-95 
job validation exit routine (see IEFUJV exit routine) 
job wait time limit 10-5 
changing value of 4-15, 4-16 
specifying (JWT parameter) 3-3 
JWT parameter (see job wait time limit) 


K 
key, storage protect 4-6 
key generator utility 6-223, 6-228 


L 

libraries, distribution, for adding exit routines 2-1 
LISTDSN parameter 3-2 

load module assignment for exit routines 2-1 
local system queue area (LSQA), subpools in 4-34 
logical control unit, record written for 6-197 
logoff record (type 35) 6-95 

logon, record written for 6-53 

LONG=YES parameter, use with WITOR macro 4-6 
lost data, minimizing 3-7 

LSQA (local system queue area), subpools in 4-34 


M 
macro instructions 
GETMAIN = 4-26, 4-34 
IFASMFR = 4-35 
SMFDETAL 4-42 
SMFEWTM 4-37 
SMFINTVL 4-41 
SMFRTEST 4-39 
SMFWTM 4-36 
WAIT 4-7 
WTOR 4-7 
magnetic tape volumes, error statistics record 6-54 
MANX data set, SMFWITM macro definition for writing to 
4-26 
mass storage control (MSC) 
configuration 6-56 
move offline 6-37 
move online 6-35 
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MAXDORM parameter 3-3 
measurement interval, record written for 6-172, 6-194, 6-207 
messages 
SYSOUT 

from IEFACTRT = 4-20 

from IFASMFDP 2-7 

from SMF data set status 3-2 
MODIFY TCAM operator command, record written when 

issued 6-86 

module assignments for exit routines 2-1 
modules interfacing with exit routines 4-3 
Monitor I activity record (type 78) 6-197 
Monitor II, reports, record subtype sections 6-207 
Monitor II activity record (type 79) 6-207 
MSC (see mass storage control) 
MVS/BDT, file-to-file transmission record (type 59) 6-142 


N 
network 
Logical Data Manager (NLDM) 6-107 
Performance Monitor Statistics (NPM) 6-106 
SIGNOFF record 6-141 
SYSOUT transmission 6-139, 6-140 
termination of a session 6-141 
problem determination application record see NPDA 
networking, start command, record written when issued 
6-137 
NJE, transaction type section, record (type 59) 6-144 
NOACTIVE parameter 3-2 
NODETAIL parameter 3-4 
NOEXITS parameter 3-4 
NOINTERVAL parameter 3-4 
NOLISTDSN parameter 3-2 
NOMAXDORM parameter 3-3 
non-temporary data sets 
REC parameter, use in writing SMF record type 17 6-49 
scratching 6-49 
non-VSAM data set activity records, INPUT or RDBACK 
(type 14) 6-38 
non-VSAM data sets 
closing 6-38 
renaming 6-50 
NOPROMPT parameter 3-3 
NOSTATUS parameter 3-3 
NOTYPE parameter 3-3 
NPDA record (type 37) 6-100 


O 
opening VSAM components or clusters 6-150 
operation of SMF, overview 1-1 
operator commands (see commands, operator) 
OUTIN, OUTPUT, UPDAT, or INOUT data set activity record 
(type 15) 642 
OUTLIM parameter 4-17 
OUTPUT, UPDAT, INOUT, or OUTIN data set activity record 
(type 15) 6-42 
output writer record 
JES2 (type 6) 6-20 
JES3 (type 6) 6-25 


I-6 System Management Facilities (SMF) 














P 
page data set, record written for 6-188 
page/swap data set activity record (type 75) 6-188 
paging activity record (type 71) 6-172 
parameter area, common exit 4-7 
parameters 
SMFPRMxx 
adding or replacing from console 3-14 
coding restrictions 3-13 
contents and formats 3-4 
defaults 3-12 
entering into SYSI1.PARMLIB = 3-12 
selecting records using 3-12 
using the DISPLAY SMF command 3-15 
using the SET SMF command =. 3-13 
subsystem 
changing 4-44 
determining 4-43 
performance 2-7 
performance group, record written for 6-180 


programmed cryptographic facility, record written for 6-222 


purging a job 
JES2 6-66 
JES3 6-70 
R 


RACF (Resource Access Control Facility) 6-53, 6-221 
RACF initialization record (type 81) 6-221 
RACF processing record (type 80) 6-221 
RDBACK or INPUT data set activity record (type 14) 6-38 
RDW (record descriptor word) 4-36, 4-38, 6-1, 6-2, 6-3 
REC parameter 3-2 
record descriptor word (see RDW) 
record interval, how to specify 3-7 
record length, minimum for using sort 5-1 
recording not available record (type 7) 6-33 
recording status changes 3-10 
records 
SMF 
addressing 4-35 
contents and formats 6-5, 6-6, 6-7 
segmenting 2-6 
selecting 3-12 
sorting 5-1 
standard header 6-1 
summary of 6-4 
testing recording of 4-42 
types (see Table of Contents for specific types) 
recovery allocation record (type 10) 6-36 
reenterable attribute 4-5 
register usage 4-6 
remote user 
JES2 
record written when signing off 6-134 
record written when signing on 6-130, 6-133 
JES3, tecord wiitien when signing on 6-131 
removing devices from configuration 6-37, 6-56 
renaming non-VSAM data sets 6-50 
report, summary activity 2-14 
report programs 1-5, 5-4 
restarting a line, JES2 6-126, 6-133, 6-134 
restarting SMF, use of SET SMF operator command 3-13 














restrictions 
exit routines 
(see also restrictions, SMF) 
adding exit routines to system 2-1 
adding or modifying JCL 4-9, 4-11 
coding the TIME=parameter 4-16 
communicating with IEFU83 4-18 
communicating with IEFU84 4-18 
extending job/step execution time 4-16 
reenterable attribute 4-5 
system interlock 4-15 
writing to system defined datasets 4-5, 4-6 
WTOR macro instructions 4-7 
SMF (see also restrictions, exit routines) 
coding SMFPRMxx parameters 3-13 
maximum SYSOUT message length 4-21 
RETKEY function 6-223, 6-225 
return codes 
IEFACTRT exit routine 4-20 
IEFUJI exit routine 4-11 
IEFUJP exit routine 4-22 
IEFUJV exit routine 4-9 
IEFUSI exit routine 4-12 
IEFUSO exit routine 4-17 
IEFUTL exit routine 4-15 
IEFU29 exit routine 4-23 
IEFU83 exit routine 4-17 
IEFU84 exit routine 4-18 
SMF dump program 2-7 
SMFCHSUB 4-44 
SMFDETAL 4-42 
SMFEWTM 4-37 
SMFEXIT 4-40 
SMFINTVL 4-41 
SMFRTEST 4-39 
SMFSUBP 4-43 
SMFWTM 4-37 
RMF 
measurement interval, record written atend of 6-188 
Monitor I activity 6-197 
Monitor II activity 6-207 
records produced by 6-165 
routines 
user-written exit (see exit routines, SMF) 
user-written exit report 5-4 


Ss 
S JES2, record written when issued 6-119 
sample data set space requirements 2-5 
sample DD statements 2-4 
sample exit routines 4-4 
sample job, dumping SMF data sets 2-12 
sample sort procedure 5-2 
sample uses of SMF data 14 
analyzing the configuration 1-11 
billing users 1-5 
evaluating data set activity 1-14 
profiling system resource usage 1-5, 1-15 
reporting reliability 1-10 
scheduling jobs 1-11 
summarizing DASD volume activity 1-13 


saving registers 4-6 
scratching 
non-temporary data sets 6-49 
temporary data sets 6-49 
security record (type 82) 6-222, 6-227 
service level reporter, use of 1-5 
session termination, record written for 6-172, 6-194, 6-207 
SET DAE, operator command, module writing SMF record 
type 90 6-232 
SET DATE 
operator command 
module writing SMF record type 90 6-232 
record written when issued 6-34 
SET ICS, operator command, module writing SMF record type 
90 6-232 
SET IPS, operator command, module writing SMF record type 
90 6-232 
SET MPF, operator command, module writing SMF record 
type 90 6-232 
SET OPT, operator command, module writing SMF record 
type 90 6-232 
SET SMF 
operator command 
module writing SMF record type 90 6-232 
tracking 3-10 
use in modifying options 3-13 
use in restarting SMF 3-13 
use in specifying SMFPRMxx parmlib member 3-13 
use of 3-] 
used to restart SMF 1-1 
SET TIME, operator command, module writing SMF record 
type 90 6-232 
SETDMN, operator command, module writing SMF record 
type 90 6-232 
SETSMF 
operator command 3-14 
module writing SMF record type 90 6-232 
use of 3-1 
SID parameter 3-2 
SIGNOFF, JES2 network record 6-141 
SIGNOFF /stop line record, JES2 (type 48) 6-126 
SIGNOFF/stop line record/LOGOFF, JES3 (type 48) 6-227 
SIGNON/start line record, JES2 (type 47) 6-123 
SIGNON/start line record/LOGON, JES3 (TYPE 47) 6-124 
SMF 
address space 1-1 
buffer 1-1 
number 2-3 
size 2-3 
control blocks 1-1 
data sets 
preformatted with dummy records 2-6, 5-1 
defining the use of 3-1 
definition 1-1 
dump program, use in creating data sets 5-1 
exit (see exit routines, SMF) 
functions 3-6 
options, replacing 3-13 
overview 1-1 
performance 2-7 
record exit 4-18, 10-8, 10-9 
records 
fieldsin 7-1 
records containing field 7-1 
restrictions (see restrictions, SMF) 


Index JI-7 














SMF buffer 2-3 
storage requirements 2-3 
SMF data sets 
allocating space for 2-4 
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contents and formats 3-2, 3-3, 3-4 
defaults 3-12 
entering intoSYS1.PARMLIB =‘ 3-12 
functions controlled by 3-6 
selecting records using 3-12 
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standard SMF header 6-1 

START operator command, use with SMF dump program 
2-12 

started task accounting 3-10 

starting a line 
JES2 6-119, 6-133 
JES3 6-124 

starting JES2 6-119 

starting JES3 6-120 

statistics, collecting SMF 3-6 

status changes, recording 3-10 

STATUS parameter 3-3 

step CPU time limit 4-15, 4-16, 10-5 

step initiation exit routine (see IEFUSI exit routine) 

step termination records 
for background jobs (type 4) 6-12 
for foreground jobs (type 34) 6-90 

stopping a line 
JES2 6-126, 6-134 
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storage protect keys 4-6 


SUBPARM parameter 3-5 
subpools 

required for additional work areas 4-34 

required when using TESTEXIT 4-28 
SUBSYS parameter 3-5 

to control started task accounting 3-10 
subsystem 

data, specifying 3-5 

definition of 3-5 

parameters 

changing 4-44 
determining 4-43 

passing data to 3-11 
subtype selectivity option, description 3-6 
summary activity report 2-14, 2-15 
swap data set, record written for 6-188 
SWITCH operator command 

function 2-7 

record written when issued 6-51 
SWITCH SMF, operator command, module writing SMF record 

type 90 6-134 
switching recording on SMF data sets 1-4, 2-7 
symbolically addressing SMF fields 4-36 
SYS parameter 3-3 
SYSOUT limit exit routine (see IEFUSO exit routine) 
SYSOUT messages 

from IEFACTRT 4-20 

from IFASMFDP 2-7 
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IEFUSI — Job Initiation Exit 4-11, 104 
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specifying 3-2 
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system queue area (SQA), subpoolsin 4-34 
system resource usage, reporting on 1-15 
system status record (type 90) 6-132 
SYS1.ALPALIB, addressing exit routines to 2-1 
SYS1.AOSB3, adding exit routines to 2-1 
SYS1.AOS00, adding exit routines to 2-1 
SYS1.ASMPLIB 

SMFEXITS 4-3 

SMFE15 5-1 

SMFE35 5-1 

SMFFRMT 5-4 

SMFSORT 5-1 

TESTEXIT 4-26 
SYS1.MACLIB 4-35 
SYS1.MANn (see SMF data sets) 
SYS1.PARMLIB, adding SMFPRMxx member to 3-12 
SYS1.RMFMACO1, ERBSMFR resides in 6-165 


T 
temporary data sets 
REC parameter, use in writing SMF record type 17 6-49 
scratching 6-49 
termination exit rotuine (see IEFACTRT exit routine) 
TESTEXIT procedure 4-25 
testing detailrecording 4-42 
testing exit routines 4-25 
testing record recording 4-29 
throughput 2-7 
time extension, minimum 4-16 
time limit exit routine (see IEFUTL exit routine) 
time limits 4-15, 10-5 
TIOC initialization record (type 31) 6-86 
trace activity record (type 76) 6-191 
transaction billing 1-9 
developing method of 1-9 
for heavy TSO users 1-6 
transactional data, written by CICS/VS 6-238 
TSO 
command accounting 3-8 
objectives 1-6 
records 
logoff (type 35) 6-90 
step termination (type 34) 6-90 
user work accounting (type 32) 6-86 
tuning statistics, ACF/VTAM 6-132 
TYPE/NOTYPE, subtype selectivity option 3-6 


U 
unallocation request, record written when issued 6-113 
unit 
cryptographic 
address 6-228 
status 6-228 
UPDAT, OUTPUT, INOUT, or OUTIN data set activity record 
(type 15) 6-42 
use of SMF data, sample, 1-4 
user communication field 4-7 








user-defined data set 4-6 
user-identification field 4-7 
uset-written exit routines (see exit routines, SMF) 
user-written exit routines 
exit (see exit routines, SMF) 
report 1-4 
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VARY device OFFLINE record (type 11) 6-37 
VARY device ONLINE record (type 9) 6-35 
volume error statistics record (type 21) 6-54 


volumes 
tape 6-54 
VSAM 6-153 


VSAM catalog entries 
defining 6-151 
deleting 6-41 
extending 6-151 
renaming 6-163 
VSAM cluster 
closing 6-153 
defined closed or deleted 6-146 
opening 6-150 
VSAM component 
closing 6-153 
opening 6-150 
VSAM component or cluster opened record (type 62) 6-150 
VSAM component or cluster status record (type 64) 6-153 
VSAM components or clusters, closing 6-145, 6-153 
VSAM data space defined, extended or deleted record 
(type 69) 6-164 
VSAM data spaces 
defining 6-164 
deleting 6-164 
extending 6-164 
VSAM entry defined record (type 63) 6-151 
VSAM entry deleted record (type 67) 6-151 
VSAM entry renamed record (type 68) 6-163 
VSAM volume data set updated record (type 60) 6-146 
VSAM volume record, record written when added or deleted 
6-146 
VSAM volumes 
space unavailable on 6-153 
switching 6-153 
VSPC, records written by 6-119, 6-121, 6-123, 
6-126 
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WAIT macro instruction 4-7 

wait time, specifying limit 3-3 

work areas, obtaining 4-34 

workload activity record (type 72) 6-180 
WORKREG, register used in 31-bit addressing 4-40 
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